Update Subscription

Update shopper subscription preference

POST/organizations/{organizationId}/subscriptions

Use it in a workflow

Add a step and choose the Salesforce Commerce Cloud connector.
Pick the Update Subscription action (under Shopper Consents).
Fill in the fields below, then reference the result from later steps as {{updateSubscription.response.data}}.

Request

Path parameters

organizationIdstringrequired

An identifier for the organization the request is being made by

Query parameters

siteIdstringrequired

The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.

localeoneOf

A descriptor for a geographical region by both a language and country code. By combining these two, regional differences in a language can be addressed, such as with the request header parameter `Accept-Language` following [RFC 2616](https://tools.ietf.org/html/rfc2616) & [RFC 1766](https://tools.ietf.org/html/rfc1766). This can also just refer to a language code, also RFC 2616/1766 compliant, as a default if there is no specific match for a country. Finally, can also be used to define default behavior if there is no locale specified.

Request body

Enter the body as JSON in the step's Body field.

subscriptionIdstringrequired

Identifier for the communication subscription

contactPointValuestringrequired

The customer's contact point value, polymorphic based on the channel type as below: - `sms` - Subject's phone number in E.164 format, ex: `+1 424 535 3546` - `email` - Subject's email address in RFC 5321 & RFC 5322 format, ex: `jack.sparrow@salesforce.com`

channelstringrequired

One ofemailsmswhatsapp

statusstringrequired

The consent status of the subscription as supplied or recorded by this system

One ofopt_inopt_out

json

{
  "subscriptionId": "weekly-newsletter",
  "contactPointValue": "jack.sparrow@salesforce.com",
  "channel": "email",
  "status": "opt_in"
}

Response

Returns 200 with an object. Read it in later steps with {{updateSubscription.response.data.<field>}}.

subscriptionIdstring

Identifier for the communication subscription

channelstring

One ofemailsmswhatsapp

contactPointValuestring

statusstring

The consent status of the subscription as supplied or recorded by this system

One ofopt_inopt_out

json

{
  "subscriptionId": "weekly-newsletter",
  "channel": "email",
  "contactPointValue": "jack.sparrow@salesforce.com",
  "status": "opt_in"
}

Need more? See the Salesforce Commerce Cloud guide for connection setup and behaviour shared by every action.

Was this page helpful?