ITiterable
lists

Add subscribers to list

Add specific subscribers to a list.<br/><br/>Learn about <a href="https://support.iterable.com/hc/articles/29156459027348">identifying users by <code>userId</code> and <code>email</code></a>.

post/api/lists/subscribe

Request

  • Base URL
    https://api.iterable.com
  • Auth
    API key in header Api-Key

Request body

listIdinteger required
updateExistingUsersOnlyboolean

Whether to skip operation when the request includes a <code>userId</code> or <code>email</code> that doesn't yet exist in the Iterable project. When <code>true</code>, Iterable ignores requests with unknown userIds and email addresses. When <code>false</code>, Iterable creates new users. Defaults to <code>false</code>. Only respected in API calls for <a href="https://support.iterable.com/hc/articles/29156459027348">userID-based and hybrid projects</a>.

Response

successful operation

createdFieldsstring[]

Fields that were created because <code>createNewFields</code> was <code>true</code> or <code>createNewFields</code> was not set and the project is configured to add unrecognized user profile fields.

failCountinteger required

Number of user profiles that could not be updated. See <code>failedUpdates</code> for more details.

filteredOutFieldsstring[]

Fields that were dropped because <code>createNewFields</code> was <code>false</code> or <code>createNewFields</code> was not set and the project is configured to drop unrecognized user profile fields.

invalidEmailsstring[]

<code>email</code> addresses of users that failed to update. This field is deprecated — use <code>failedUpdates</code> instead.

invalidUserIdsstring[]

<code>userId</code> values of users that failed to update. This field is deprecated — use <code>failedUpdates</code> instead.

successCountinteger required

Number of user profiles that were updated in response to the request.

Changes

No recorded changes to this operation across all 4 revisions of this API.