Skip to main content
Version: 2025-05-27

Upload respondent unique codes for target group live url

POST 
/demand/accounts/{account_id}/target-groups/{target_group_id}/respondent-unique-codes/live

Upload respondent unique code(s) for the given target group. They will be inserted into the live URL for each respondent entering the session. This will only be used in the context of the live URL of the target group (as opposed to test codes used with the test URL).

The URL for the given target group will require setup by using [%RESPONDENT_UNIQUE_CODE%]
An example of the live URL setup: https://example_live_url.com?[%RESPONDENT_UNIQUE_CODE%]

Processing Rules:

  • Batch Size: A minimum of 1 and a maximum of 20 000 codes can be submitted in a single request.
  • Code Format: Codes must consist solely of alphanumeric characters, hyphens (-), and underscores (_). Each code must have a length between 1 and 128 characters, inclusive. All leading and trailing whitespace will be automatically removed upon submission.
  • Uniqueness and Handling of Duplicates: Within the context of this target group's respondent unique codes for live urls, only unique submissions are processed. If duplicate codes are present in the uploaded batch, only their first occurrence will be considered for addition. Codes that were previously already uploaded as live (i.e. not as test codes) for the specified target group will be ignored and won't be added again.

This endpoint is only applicable if your account has access to this feature. If your account does not have access, it will result in a 403 forbidden error. For more information, if you need this behaviour, please contact your account manager.

Request​

Responses​

Contains information on how many respondent unique codes were successfully uploaded. For example, already existing or duplicate codes will not be uploaded.