Add or update one or more emails in the optout list

put

https://api.seismic.com/integration/v2/system/optouts

Posting to this endpoint will allow one or more email addresses to be added or updated in the tracking opt-out list.

If the email address isn't already in the list, it will be added. If it is already in the list it will be updated.

Each entry in the request array carries three independent opt-out flags: emailOptOut (stop Seismic from sending email to the address), trackingOptOut (stop recording engagement activity such as opens, views and downloads for the address) and meetingsOptOut (exclude the address from meeting-related processing). Send true to opt the address out of a category and false to opt it back in. The response reports how many entries were processed and lists any email address that could not be saved together with the reason.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK. The request was processed. totalSucceeded reports how many entries were saved and errors lists any entries that could not be saved; it is empty when every entry succeeded.

400Bad Request. The request body is missing, is not a JSON array, or contains entries that could not be processed. The errors array identifies the failing email addresses.

401Unauthorized. The Authorization header is missing, or the bearer token is invalid or expired. Obtain a new token and retry.

403Forbidden. The token is valid but does not grant the scope required by this operation (seismic.configuration.view for reads, seismic.configuration.manage for changes).

429Too Many Requests. The calling client exceeded the API gateway rate limit for this route. Wait before retrying and reduce the request rate, for example by batching entries into one PUT.