Skip to main content
Version: 2025-12-18

Create a job to upload respondent IDs by file

POST 
/demand/accounts/:account_id/projects/:project_id/target-groups/:target_group_id/recontacts/jobs/upload-rsids-by-file

This endpoint creates an asynchronous job to upload a file containing Respondent IDs (RSIDs) for recontact opportunities. The new IDs will be added to any existing ones for the specified Target Group.

A successful request returns a 201 Created response with a job_id that you can use to track the file processing status.

File Format Rules​

  • The file must be in CSV or TXT format.
  • The file must not contain a header row.
  • Each line in the file must contain a single, unique Respondent ID.

Validation and Capacity Limits​

  • Total Capacity: The total number of respondent IDs for a target group (existing plus new) cannot exceed 100,000.
  • File Size: The uploaded file size must be less than 5MB.
  • Files per Job: Only one file can be uploaded per job.
Operational Constraint

Only one recontact job can run at a time per Target Group. If a job is already in Processing status for this Target Group, the API will return a 409 Conflict error.

Estimated execution time: Uploading 10,000 new respondents typically takes between 10 and 15 minutes.

Request​

Responses​

Returns the newly created job ID for tracking the file upload.