Introduction

The Contacts API provides functionality for adding and managing contacts on your site. When a new visitor shares contact information with your site, they're added to your Contact List. You can then access their contact details using the API.

A site visitor can become a contact through various methods, including but not limited to:

• Completing forms such as event registrations, membership sign-ups, customer support inquiries, or billing address submissions.
• Being manually added by a site collaborator.
• Engaging with 3rd-party integrations that leverage the Contacts API, for example, logging in with social media. Learn more about how you can manage your contact list.

With the Contacts API, you can:

• Create, update, and remove contacts.
• Retrieve contacts to access their contact information.
• Merge duplicate contacts.
• Label and unlabel contacts for categorization purposes.

Before you begin

It is important to note the following points before you begin to code:

• You can't label or unlabel a contact if the label does not yet exist. To create a label, use the Labels API.
• Merging a contact is irreversible.
• Site members and collaborators can only be used as the target contact when merging contacts.

Terminology

• Label: A tag that enables site admins to organize and group contacts.
• Extended field: An additional property that stores contact information.
• Source contact: A contact you intend to merge into a target contact. These contacts get deleted after being merged.
• Target contact: A contact that receives merged data from source contacts.