Skip to main content
POST
Create contact
Send fullName and any other details you want to save. The name must not be empty. All other fields are optional.

Create or update by email

If the email matches a saved contact in this workspace, Tapify updates that contact with the fields you send. Email matching ignores capitalization. Fields you leave out keep their existing values. Without an email address, each request creates a new contact. To change a contact whose ID you already know, use Update contact.

Assign a team member

Set connectedWithProfileId to an id from List team members. The member must belong to the same workspace. Creating or assigning a contact does not send an email to that person.

Notes and tags

Use internalNote for a private workspace note. message is the person’s submitted message and captureMethod records how the contact was collected. These two fields are read-only; including them returns 400 Bad Request. New API contacts use captureMethod: "manual".
Sending tags replaces the contact’s full tag list, including when updating a contact matched by email. Use [] to remove all tags.Tags are shared across the workspace. Reusing a tag name updates its color wherever it is used. An omitted color uses neutral.

Authorizations

Authorization
string
header
required

API key created under Settings → API keys.

Body

application/json

Create a contact, or update a saved contact matched by email in this workspace. Omitted fields on a matched contact stay unchanged. message and captureMethod are read-only and cannot be supplied.

fullName
string
required

Full name containing at least one non-whitespace character.

Minimum string length: 1
Example:

"Alex Morgan"

jobTitle
string | null
Example:

"Sales Director"

company
string | null
Example:

"Northstar"

email
string<email> | null

Email used for the case-insensitive contact lookup in this workspace.

Example:

"alex@northstar.example"

mobile
string | null

Mobile phone number.

Example:

"+31612345678"

phone
string | null

Other phone number, such as an office number.

website
string | null
Example:

"https://northstar.example"

linkedin
string | null
Example:

"https://linkedin.com/in/alex-morgan"

address
string | null
Example:

"Amsterdam, Netherlands"

internalNote
string | null

Private workspace note. Tapify does not show or send it to the contact.

Example:

"Added from our CRM."

connectedWithProfileId
string<uuid> | null

Member id from the team-members endpoint in this workspace. Use null to remove assignment. Does not send email.

Example:

"45fa16aa-2546-49b3-9d1e-7b7e1c9fb1e7"

tags
object[]

Complete replacement tag list. Include every tag to keep, or send [] to remove all. Applies to email-matched contacts too. Tag colors are shared across the workspace.

Response

Existing contact updated

data
object
required

A contact saved in the Tapify Teams workspace.