Create or update a respondent

POST

/put-respondent

curl --request POST \
  --url https://respondent.rex.dynata.com/put-respondent \
  --header 'Content-Type: application/json' \
  --header 'dynata-access-key: ABCD1234' \
  --header 'dynata-expiration: 2026-04-15T12:00:00Z' \
  --header 'dynata-signature: c156e91013eb715edb2b07df5491497a807206b1796bb7d031505107a9dbdcdf' \
  --data '{ "respondent_id": "user1234", "language": "es", "country": "US", "gender": "male", "birth_date": "1970-01-01", "postal_code": 90210, "attributes": [ { "id": 123, "answers": [ 4321 ] } ] }'

• Production
• Sandbox

Warning

Do not pass values into attributes with display_mode: none, display_mode: geo or display_mode: zip. These are derived and will not accept any value you send in. No errors will be surfaced.

Learn more here.

Respondents

Parameters

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

c156e91013eb715edb2b07df5491497a807206b1796bb7d031505107a9dbdcdf

Request Body

Media typeapplication/json

object

respondent_id

required

Partner’s respondent identifier. Accepts 100 characters, 3-byte chars.

string

language

required

string

/^[a-z]{2}$/

country

required

string

/^[A-Z]{2}$/

gender

Case insensitive value for gender

Allowed values: male m 1 female f 2

birth_date

string format: YYYY-MM-DD

postal_code

string

attributes

Array<object>

object

id

required

integer format: int64

answers

required

Array<integer>

Responses

200

Respondent created or updated successfully

400

Bad request

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

401

Invalid credentials

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

403

Unauthorized

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

422

Unprocessable Entity

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

429

Too many requests

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

Headers

retry-after

string

Example

300

The number of seconds a client must wait before making a new request.

500

Internal server error

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}