Subscribe Profiles

POST {{baseUrl}}/api/profile-subscription-bulk-create-jobs/

Subscribe one or more profiles to email marketing, SMS marketing, or both. If the list has double opt-in enabled, profiles will receive a message requiring their confirmation before subscribing. Otherwise, profiles will be immediately subscribed without receiving a confirmation message.

To add someone to a list without changing their subscription status, use Add Profile to List.

This API will remove any UNSUBSCRIBE, SPAM_REPORT or USER_SUPPRESSED suppressions from the provided profiles. Learn more about suppressed profiles in this document.

Maximum number of profile can be submitted for subscription: 100

Rate limits:
Burst: 75/s
Steady: 700/m

Scopes: list:write profiles:write subscriptions:write

Request Body

{"data"=>{"type"=>"profile-subscription-bulk-create-job", "attributes"=>{"profiles"=>{"data"=>[{"type"=>"profile", "attributes"=>{"email"=>"<string>", "phone_number"=>"<string>", "subscriptions"=>{"email"=>["MARKETING", "MARKETING"], "sms"=>["MARKETING", "MARKETING"]}}, "id"=>"<string>"}, {"type"=>"profile", "attributes"=>{"email"=>"<string>", "phone_number"=>"<string>", "subscriptions"=>{"email"=>["MARKETING", "MARKETING"], "sms"=>["MARKETING", "MARKETING"]}}, "id"=>"<string>"}]}, "custom_source"=>"<string>"}, "relationships"=>{"list"=>{"data"=>{"type"=>"list", "id"=>"<string>"}}}}}

HEADERS

KeyDatatypeRequiredDescription
revisionstring(Required) API endpoint revision (format: YYYY-MM-DD[.suffix])
Content-Typestring
Acceptstring