Re-add email addresses to email distribution lists

Re-adds email addresses to your mailing list that you added to your Yotpo email blocklist. Customers who organically unsubscribed from your mailing list will not be re-added.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
👍

How to use this endpoint

  • To see example requests, click Examples in the payload on the right.
  • For example responses, click the relevant status code on the right.
📘

Note:

  • Currently, the returned unsubscribers.id is not supported in the Yotpo API.
  • For multiple requests, Yotpo recommends passing batches of 150 emails per request.
  • If you use the async parameter, the response does not contain "unsubscribers".
  • If you use the validate_data parameter, the response will contain errors if the requested parameters are not valid.

email_list request body

The email_list object is a hash of email addresses grouped by email type. Each key must be the Number from the Email types table below (for example 1, 2, or 3). The value for each key is an array of email addresses to re-add for that email type.

For example, to re-add addresses to email type 1 (Mails After Purchase and other reminder emails):

{
  "email_list": {
    "1": [
      "[email protected]"
    ]
  }
}

To target multiple email types in one request, add a separate key for each Number from the table:

{
  "email_list": {
    "1": [
      "[email protected]"
    ],
    "3": [
      "[email protected]"
    ]
  }
}

Email types

Use the Number column below as the key in your email_list request body.

NumberEmail Type
1Mails After Purchase and other reminder emails
2Targeted Review Requests
3Mail after service: emails sent as a follow-up in Zendesk integration
4Comment requests: store owners with comments feature, get this after a new review is written
5Comment notification: reviewers get this after store owner comments on a review
6Site reminder: site review requests that sent with the 'slider' feature
7Mail after invoice: emails sent from the "Site Review Automation" feature
8Question confirmation: mail sent to confirm the email of a user who asks a question. Questions are only submitted once the poser confirms their email.
9Answer request shop owner
10Answer request shoppers
11Answer notification shop owner
12Answer notification shoppers: the notification sent to the user that asked the question that the question has been answered
13Resend reminder: this is only sent when a reminder is resent manually from the Admin
14Anonymous testimonials request: HubSpot integration emails
15Targeted Product Review request: the Targeted Product Review request email
16Coupon Reminder
17Coupon Notification
Path Params
string
required

The store ID

Body Params
email_list
object

Hash of email addresses by email type. Use the Number from the Email types table on this page as each key (for example 1, 2, or 3).

boolean

Perform subscription changes asynchronously.

string

Validate the email_list. You can only use this parameter with async.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/plain