Create or update a respondent
POST /put-respondent
POST
/put-respondent
Warning
Do not pass values into attributes with
display_mode: none,display_mode: geoordisplay_mode: zip. These are derived and will not accept any value you send in. No errors will be surfaced.
Learn more here.
Parameters
Section titled “ Parameters ”Header Parameters
Section titled “Header Parameters ” dynata-expiration
required
string format: date-time
RFC3339 timestamp indicating request expiration
dynata-access-key
required
string
Dynata provided access key
Example
ABCD1234 dynata-signature
required
string
Signature created using the dynata methodology
Example
c156e91013eb715edb2b07df5491497a807206b1796bb7d031505107a9dbdcdfRequest Body
Section titled “Request Body ”object
respondent_id
required
Partner’s respondent identifier. Accepts 100 characters, 3-byte chars.
string
language
required
string
country
required
string
gender
Case insensitive value for gender
birth_date
string format: YYYY-MM-DD
postal_code
string
attributes
Array<object>
object
id
required
integer format: int64
answers
required
Array<integer>
Responses
Section titled “ Responses ”Respondent created or updated successfully
Bad request
object
message
required
string
Invalid credentials
object
message
required
string
Unauthorized
object
message
required
string
Unprocessable Entity
object
message
required
string
Too many requests
object
message
required
string
Headers
Section titled “Headers ” retry-after
string
Example
300The number of seconds a client must wait before making a new request.
Internal server error
object
message
required
string