Skip to content

Process a segment import

POST
/api/v1/audience-import/process
curl --request POST \
--url https://renotify.app/api/v1/audience-import/process \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "path": "imports/audience.csv", "mapping": { "phone": "Mobile", "email": "Email" }, "audience_name": "Webinar Leads", "create_new_entities": true }'

Queue a segment import job using a previously uploaded file and column mapping.

Media typeapplication/json
object
path
required

The temporary upload path returned by the preview endpoint.

string
Example
imports/audience.csv
mapping
required

The detected or adjusted column mapping.

object
phone

The CSV column containing phone numbers.

string
nullable
Example
Mobile
email

The CSV column containing email addresses.

string
nullable
Example
Email
name

The CSV column containing names.

string
nullable
Example
Full Name
Example
{
"phone": "Mobile",
"email": "Email"
}
audience_name
required

The name of the segment to create.

string
Example
Webinar Leads
create_new_entities

Whether new contacts should be created for unmatched rows.

boolean
Example
true