The Contacts API allows you to upload and download the entire contact database. You can also add, update, and remove individual contacts from the database.

It's best to make changes using the Contacts API before an order is submitted. Some changes that are made to the contact database may affect existing orders, but we do not currently guarantee that a change will or will not affect an order; to change an existing order, we recommend having the user contact us directly.

(We may provide stronger guarantees in the future, particularly if we're pestered to do so.)

Permissions

Access your mailing list
Scope: contacts.read

Grants access to read all the active (not deleted) contacts in a user's active mailing list.

Change your mailing list
Scope: contacts.write

Grants access to make changes to a user's active mailing list.