Spawn Bulk Profile Import Job
POST {{baseUrl}}/api/profile-bulk-import-jobs/
Create a bulk profile import job to create or update a batch of profiles.
Accepts up to 10,000 profiles per request. The maximum allowed payload size is 5MB.
To learn more, see our Bulk Profile Import API guide.
Rate limits:
Burst: 10/s
Steady: 150/m
Scopes:
lists:write
profiles:write
Request Body
{"data"=>{"type"=>"profile-bulk-import-job", "attributes"=>{"profiles"=>{"data"=>[{"type"=>"profile", "attributes"=>{"email"=>"<string>", "phone_number"=>"<string>", "external_id"=>"<string>", "anonymous_id"=>"<string>", "_kx"=>"<string>", "first_name"=>"<string>", "last_name"=>"<string>", "organization"=>"<string>", "title"=>"<string>", "image"=>"<string>", "location"=>{"address1"=>"<string>", "address2"=>"<string>", "city"=>"<string>", "country"=>"<string>", "latitude"=>"<string>", "longitude"=>"<string>", "region"=>"<string>", "zip"=>"<string>", "timezone"=>"<string>", "ip"=>"<string>"}, "meta"=>{"patch_properties"=>{"unset"=>"<string>"}}}, "id"=>"<string>"}, {"type"=>"profile", "attributes"=>{"email"=>"<string>", "phone_number"=>"<string>", "external_id"=>"<string>", "anonymous_id"=>"<string>", "_kx"=>"<string>", "first_name"=>"<string>", "last_name"=>"<string>", "organization"=>"<string>", "title"=>"<string>", "image"=>"<string>", "location"=>{"address1"=>"<string>", "address2"=>"<string>", "city"=>"<string>", "country"=>"<string>", "latitude"=>"<string>", "longitude"=>"<string>", "region"=>"<string>", "zip"=>"<string>", "timezone"=>"<string>", "ip"=>"<string>"}, "meta"=>{"patch_properties"=>{"unset"=>"<string>"}}}, "id"=>"<string>"}]}}, "relationships"=>{"lists"=>{"data"=>[{"type"=>"list", "id"=>"<string>"}, {"type"=>"list", "id"=>"<string>"}]}}}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
revision | string | (Required) API endpoint revision (format: YYYY-MM-DD[.suffix]) | |
Content-Type | string | ||
Accept | string |