v1

latestOpenAPI 3.0.02026-07-2633090.6 KB

campaign

Upload Campaign CSV (Beta)

Beta endpoint for large campaigns of 5k+ rows. Uploads and validates a CSV asynchronously, creating a draft bulk list.

post/campaign/upload-csv

Headers

X-API-KEYstring required

Example:7251cb4b-3373-43a4-844c-b27a1d45e0c9

(Required) Your Ringg AI API key.

Response

CSV upload accepted for asynchronous validation.

bulk_list_idstring

statusstring

campaign_namestring

total_calleesinteger

invalidated_rows_countinteger

invalidated_rows_csv_urlstring nullable

Example response

{
  "bulk_list_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "verifying",
  "campaign_name": "Renewal reminders - large upload",
  "total_callees": 0,
  "invalidated_rows_count": 0,
  "invalidated_rows_csv_url": null
}