Lists

Add a contact to a list

Changed on

Adds an existing contact to a list. If the contact is already in the list, no duplicate is created.

post/lists/{list_id}/contacts

Request

  • Base URL
    https://api.sendfox.com
  • Auth
    OAuth 2
    Authorization codehttps://sendfox.com/oauth/authorize
    Token URLhttps://sendfox.com/oauth/token

Request body

contact_idinteger required

ID of the contact to add

Response

Contact added to list

idinteger
emailstring email required
first_namestring
last_namestring
ip_addressstring
unsubscribed_atstring date-time nullable
bounced_atstring date-time nullable

When this address hard bounced. A hard bounce also sets unsubscribed_at. If unsubscribed_at is null, or far from this date, the bounce isn't what's stopping their email; they were resubscribed or opted out separately.

bounce_paused_atstring date-time nullable

When this contact was last paused for repeated bounces. Can remain set after the pause has ended; read bounce_paused_until to tell.

bounce_paused_untilstring date-time nullable

When the current repeated-bounce pause ends. Null if the contact isn't paused, or has since unsubscribed or become invalid, since no retry is coming.

invalid_atstring date-time nullable

When this address was found to be invalid. It isn't mailed while this is set.

created_atstring date-time
updated_atstring date-time

Changes

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the media type application/json for the response with the status