Create contact

curl --request POST \
  --url https://tapify.app/api/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fullName": "Alex Morgan"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({fullName: 'Alex Morgan'})
};

fetch('https://tapify.app/api/v1/contacts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "id": "f08f7c49-8f1e-42ac-b5ac-e0d6bd37d938",
    "workspaceId": "9df81bd4-3d76-42cc-9518-a019ea75a221",
    "fullName": "Alex Morgan",
    "jobTitle": "Sales Director",
    "company": "Northstar",
    "email": "alex@northstar.example",
    "mobile": "+31612345678",
    "phone": "<string>",
    "website": "https://northstar.example",
    "linkedin": "https://linkedin.com/in/alex-morgan",
    "address": "Amsterdam, Netherlands",
    "message": "Interested in a demo.",
    "internalNote": "Met at Tech Expo.",
    "connectedWith": {
      "id": "45fa16aa-2546-49b3-9d1e-7b7e1c9fb1e7",
      "name": "Mina Park",
      "avatarUrl": "https://example.com/mina.jpg"
    },
    "tags": [
      {
        "name": "Follow up",
        "color": "neutral"
      }
    ],
    "details": [
      {
        "type": "email",
        "value": "alex@northstar.example",
        "isPrimary": true
      }
    ],
    "createdAt": "2026-07-28T09:30:00.000Z",
    "enrichedAt": "2023-11-07T05:31:56Z",
    "created": true
  }
}

{
  "data": {
    "id": "f08f7c49-8f1e-42ac-b5ac-e0d6bd37d938",
    "workspaceId": "9df81bd4-3d76-42cc-9518-a019ea75a221",
    "fullName": "Alex Morgan",
    "jobTitle": "Sales Director",
    "company": "Northstar",
    "email": "alex@northstar.example",
    "mobile": "+31612345678",
    "phone": "<string>",
    "website": "https://northstar.example",
    "linkedin": "https://linkedin.com/in/alex-morgan",
    "address": "Amsterdam, Netherlands",
    "message": "Interested in a demo.",
    "internalNote": "Met at Tech Expo.",
    "connectedWith": {
      "id": "45fa16aa-2546-49b3-9d1e-7b7e1c9fb1e7",
      "name": "Mina Park",
      "avatarUrl": "https://example.com/mina.jpg"
    },
    "tags": [
      {
        "name": "Follow up",
        "color": "neutral"
      }
    ],
    "details": [
      {
        "type": "email",
        "value": "alex@northstar.example",
        "isPrimary": true
      }
    ],
    "createdAt": "2026-07-28T09:30:00.000Z",
    "enrichedAt": "2023-11-07T05:31:56Z",
    "created": true
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Request body is invalid.",
    "details": {}
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Request body is invalid.",
    "details": {}
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Request body is invalid.",
    "details": {}
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Request body is invalid.",
    "details": {}
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Request body is invalid.",
    "details": {}
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Request body is invalid.",
    "details": {}
  }
}

POST

contacts

Create contact

curl --request POST \
  --url https://tapify.app/api/v1/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fullName": "Alex Morgan"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({fullName: 'Alex Morgan'})
};

fetch('https://tapify.app/api/v1/contacts', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "id": "f08f7c49-8f1e-42ac-b5ac-e0d6bd37d938",
    "workspaceId": "9df81bd4-3d76-42cc-9518-a019ea75a221",
    "fullName": "Alex Morgan",
    "jobTitle": "Sales Director",
    "company": "Northstar",
    "email": "alex@northstar.example",
    "mobile": "+31612345678",
    "phone": "<string>",
    "website": "https://northstar.example",
    "linkedin": "https://linkedin.com/in/alex-morgan",
    "address": "Amsterdam, Netherlands",
    "message": "Interested in a demo.",
    "internalNote": "Met at Tech Expo.",
    "connectedWith": {
      "id": "45fa16aa-2546-49b3-9d1e-7b7e1c9fb1e7",
      "name": "Mina Park",
      "avatarUrl": "https://example.com/mina.jpg"
    },
    "tags": [
      {
        "name": "Follow up",
        "color": "neutral"
      }
    ],
    "details": [
      {
        "type": "email",
        "value": "alex@northstar.example",
        "isPrimary": true
      }
    ],
    "createdAt": "2026-07-28T09:30:00.000Z",
    "enrichedAt": "2023-11-07T05:31:56Z",
    "created": true
  }
}

{
  "data": {
    "id": "f08f7c49-8f1e-42ac-b5ac-e0d6bd37d938",
    "workspaceId": "9df81bd4-3d76-42cc-9518-a019ea75a221",
    "fullName": "Alex Morgan",
    "jobTitle": "Sales Director",
    "company": "Northstar",
    "email": "alex@northstar.example",
    "mobile": "+31612345678",
    "phone": "<string>",
    "website": "https://northstar.example",
    "linkedin": "https://linkedin.com/in/alex-morgan",
    "address": "Amsterdam, Netherlands",
    "message": "Interested in a demo.",
    "internalNote": "Met at Tech Expo.",
    "connectedWith": {
      "id": "45fa16aa-2546-49b3-9d1e-7b7e1c9fb1e7",
      "name": "Mina Park",
      "avatarUrl": "https://example.com/mina.jpg"
    },
    "tags": [
      {
        "name": "Follow up",
        "color": "neutral"
      }
    ],
    "details": [
      {
        "type": "email",
        "value": "alex@northstar.example",
        "isPrimary": true
      }
    ],
    "createdAt": "2026-07-28T09:30:00.000Z",
    "enrichedAt": "2023-11-07T05:31:56Z",
    "created": true
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Request body is invalid.",
    "details": {}
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Request body is invalid.",
    "details": {}
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Request body is invalid.",
    "details": {}
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Request body is invalid.",
    "details": {}
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Request body is invalid.",
    "details": {}
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "Request body is invalid.",
    "details": {}
  }
}

Send at least the contact’s full name. All other fields are optional. If you include an email address, Tapify uses it to prevent duplicates. When the email matches an existing contact, Tapify updates that contact with the fields you send and leaves their other details unchanged. Without an email address, each request creates a new contact. To assign the contact to a team member, set connectedWithProfileId to that member’s id. The member must belong to the same workspace. Creating or assigning a contact through the API does not send email. message and captureMethod are set by Tapify and cannot be changed through the API. Use internalNote for a private note that is visible only inside the workspace.

Authorizations

Authorization

string

header

required

API key created under Settings → API keys.

Body

application/json

Details for a new contact. When the email already exists, Tapify updates that contact with the fields in this request.

fullName

string

required

Contact's full name.

Example:

"Alex Morgan"

jobTitle

string | null

Example:

"Sales Director"

company

string | null

Example:

"Northstar"

string<email> | null

Email address. Tapify uses it to prevent duplicate contacts.

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"

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

Team member ID to assign to the contact. The member must be in the same workspace. This does not send email.

Example:

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

Response

Existing contact updated

data

object

required

A contact saved in the Tapify Teams workspace.

Show child attributes

Getting started

Workspace

Contacts

Team members

Create contact

Authorizations

Body

Response