Contact aanmaken

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.",
    "captureMethod": "manual",
    "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",
    "updatedAt": "2026-07-29T10:00: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.",
    "captureMethod": "manual",
    "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",
    "updatedAt": "2026-07-29T10:00:00.000Z",
    "enrichedAt": "2023-11-07T05:31:56Z",
    "created": true
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "fullName is required."
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "API key is invalid or revoked."
  }
}

{
  "error": {
    "code": "subscription_required",
    "message": "Tapify Teams Connect is required for this feature."
  }
}

{
  "error": {
    "code": "payload_too_large",
    "message": "Request body is too large."
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded.",
    "details": {
      "retryAfter": 30
    }
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong."
  }
}

POST

contacts

Contact aanmaken

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.",
    "captureMethod": "manual",
    "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",
    "updatedAt": "2026-07-29T10:00: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.",
    "captureMethod": "manual",
    "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",
    "updatedAt": "2026-07-29T10:00:00.000Z",
    "enrichedAt": "2023-11-07T05:31:56Z",
    "created": true
  }
}

{
  "error": {
    "code": "bad_request",
    "message": "fullName is required."
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "API key is invalid or revoked."
  }
}

{
  "error": {
    "code": "subscription_required",
    "message": "Tapify Teams Connect is required for this feature."
  }
}

{
  "error": {
    "code": "payload_too_large",
    "message": "Request body is too large."
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded.",
    "details": {
      "retryAfter": 30
    }
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong."
  }
}

Stuur fullName en de overige gegevens die je wilt opslaan. De naam mag niet leeg zijn. Alle andere velden zijn optioneel.

Aanmaken of bijwerken op basis van e-mail

Als het e-mailadres overeenkomt met een opgeslagen contact in deze workspace, werkt Tapify dat contact bij met de velden die je meestuurt. Hoofdletters maken bij het vergelijken van e-mailadressen geen verschil. Velden die je weglaat, behouden hun bestaande waarde. Zonder e-mailadres maakt elk verzoek een nieuw contact aan. Ken je de ID van een bestaand contact? Gebruik dan Contact bijwerken.

Resultaat	HTTP-status	`data.created`
Nieuw contact	`201 Created`	`true`
Bestaand contact bijgewerkt	`200 OK`	`false`

Een teamlid toewijzen

Gebruik voor connectedWithProfileId een id uit Teamleden ophalen. Het teamlid moet bij dezelfde workspace horen. Een contact aanmaken of toewijzen verstuurt geen e-mail naar die persoon.

Notities en tags

Gebruik internalNote voor een interne notitie in de workspace. message is het bericht dat de persoon zelf heeft ingevuld en captureMethod geeft aan hoe het contact is verzameld. Deze twee velden kun je alleen lezen. Als je ze meestuurt, krijg je 400 Bad Request. Nieuwe contacten uit de API krijgen captureMethod: "manual".

Als je tags meestuurt, vervang je de volledige taglijst. Dit geldt ook als je een bestaand contact bijwerkt op basis van het e-mailadres. Gebruik [] om alle tags te verwijderen.Tags worden gedeeld binnen de workspace. Hergebruik je een tagnaam, dan wordt de kleur overal bijgewerkt. Zonder kleur wordt neutral gebruikt.

Autorisaties

Authorization

string

header

vereist

API-sleutel die is gemaakt via Instellingen → API-sleutels.

Body

application/json

Maak een contact aan of werk een opgeslagen contact in deze workspace bij op basis van een overeenkomend e-mailadres. Weggelaten velden van een overeenkomend contact blijven ongewijzigd. message en captureMethod zijn alleen-lezen en kunnen niet worden meegestuurd.

fullName

string

vereist

Volledige naam met ten minste één teken dat geen witruimte is.

Minimum string length: 1

Voorbeeld:

"Alex Morgan"

jobTitle

string | null

Voorbeeld:

"Sales Director"

company

string | null

Voorbeeld:

"Northstar"

string<email> | null

E-mailadres waarmee het contact in deze workspace wordt opgezocht, zonder onderscheid tussen hoofdletters en kleine letters.

Voorbeeld:

"alex@northstar.example"

mobile

string | null

Mobiel telefoonnummer.

Voorbeeld:

"+31612345678"

phone

string | null

Ander telefoonnummer, zoals een kantoornummer.

website

string | null

Voorbeeld:

"https://northstar.example"

string | null

Voorbeeld:

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

address

string | null

Voorbeeld:

"Amsterdam, Netherlands"

internalNote

string | null

Interne notitie in de workspace. Tapify toont of verstuurt deze niet aan het contact.

Voorbeeld:

"Added from our CRM."

connectedWithProfileId

string<uuid> | null

Id van het teamlid uit het team-members-endpoint in deze workspace. Gebruik null om de toewijzing te verwijderen. Verstuurt geen e-mail.

Voorbeeld:

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

Respons

Bestaand contact bijgewerkt

data

object

vereist

Een contact dat is opgeslagen in de Tapify Teams-workspace.

Show child attributes

Aan de slag

Workspace

Contacten

Teamleden

Zapier

Contact aanmaken

Aanmaken of bijwerken op basis van e-mail

Een teamlid toewijzen

Notities en tags

Autorisaties

Body

Respons

​Aanmaken of bijwerken op basis van e-mail

​Een teamlid toewijzen

​Notities en tags

Autorisaties

Body

Respons

Aanmaken of bijwerken op basis van e-mail

Een teamlid toewijzen

Notities en tags