/responses/live

post

https://api.goodays.co/v2/responses/live

Creates a participation right away, as soon as you collected it in your own tool (kiosk, app, call center...). The participation is processed like any participation collected by Goodays, unless its survey has been set up by your Goodays project contact to feed statistics and analyses only. A 201 means the participation is recorded.

See Become a collection source and Live or historical import.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

use_workflows

string

enum

Only send use_workflows=true, and only when your Goodays project contact asks you to. Otherwise, leave this parameter out of the URL: do not send use_workflows=false.

Allowed:

Body Params

date

string

required

Date of the participation of the end customer (ISO 8601, for example 2020-08-07T01:29:30+02:00). Cannot be in the future.

place

string

required

Place ID or External ID of the point of sale.

survey

string

Survey ID, from /surveys.

answers

array of strings

required

List of answers: {"question": "<question ID>", "value": <value>}. Can be empty when you only send a verbatim.

answers*

medium

string

Collection channel of the participation, for example TE (transactional email), TS (transactional SMS) or MOB (mobile). Ask your Goodays project contact for yours.

collect_uid

string

Your unique identifier for the participation. If it already exists for your account, the participation is rejected with a 409.

Response

201Created