Teamlid aanmaken

curl --request POST \
  --url https://tapify.app/api/v1/team-members \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "Mina",
  "lastName": "Park",
  "email": "mina@acme.com"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({firstName: 'Mina', lastName: 'Park', email: 'mina@acme.com'})
};

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

{
  "data": {
    "id": "45fa16aa-2546-49b3-9d1e-7b7e1c9fb1e7",
    "workspaceId": "9df81bd4-3d76-42cc-9518-a019ea75a221",
    "accountId": "0e35f7a8-e866-4f5d-b9cb-06961a130fef",
    "status": "active",
    "firstName": "Mina",
    "lastName": "Park",
    "displayName": "Mina Park",
    "email": "mina@acme.com",
    "jobTitle": "Head of Partnerships",
    "department": "Partnerships",
    "avatarUrl": "https://example.com/mina.jpg",
    "profileUrl": "https://tapify.app/mina-park",
    "slug": "mina-park",
    "contact": {
      "phone": "+31612345678",
      "whatsapp": "<string>",
      "website": "https://acme.com"
    },
    "contactDetails": [
      {
        "id": "33d5f285-64f7-41aa-bf9e-17a0fbf535af",
        "type": "phone",
        "label": "Mobile",
        "value": "+31612345678",
        "platform": "facebook",
        "address": {
          "line1": "Keizersgracht 391 A",
          "line2": "",
          "city": "Amsterdam",
          "postalCode": "1016 EJ",
          "country": "NL"
        }
      }
    ],
    "createdAt": "2026-07-01T09:30:00.000Z",
    "updatedAt": "2026-07-28T10:15:00.000Z",
    "created": true
  }
}

{
  "data": {
    "id": "45fa16aa-2546-49b3-9d1e-7b7e1c9fb1e7",
    "workspaceId": "9df81bd4-3d76-42cc-9518-a019ea75a221",
    "accountId": "0e35f7a8-e866-4f5d-b9cb-06961a130fef",
    "status": "active",
    "firstName": "Mina",
    "lastName": "Park",
    "displayName": "Mina Park",
    "email": "mina@acme.com",
    "jobTitle": "Head of Partnerships",
    "department": "Partnerships",
    "avatarUrl": "https://example.com/mina.jpg",
    "profileUrl": "https://tapify.app/mina-park",
    "slug": "mina-park",
    "contact": {
      "phone": "+31612345678",
      "whatsapp": "<string>",
      "website": "https://acme.com"
    },
    "contactDetails": [
      {
        "id": "33d5f285-64f7-41aa-bf9e-17a0fbf535af",
        "type": "phone",
        "label": "Mobile",
        "value": "+31612345678",
        "platform": "facebook",
        "address": {
          "line1": "Keizersgracht 391 A",
          "line2": "",
          "city": "Amsterdam",
          "postalCode": "1016 EJ",
          "country": "NL"
        }
      }
    ],
    "createdAt": "2026-07-01T09:30:00.000Z",
    "updatedAt": "2026-07-28T10:15:00.000Z",
    "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": "conflict",
    "message": "This email is already in use."
  }
}

{
  "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

team-members

Teamlid aanmaken

curl --request POST \
  --url https://tapify.app/api/v1/team-members \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "Mina",
  "lastName": "Park",
  "email": "mina@acme.com"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({firstName: 'Mina', lastName: 'Park', email: 'mina@acme.com'})
};

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

{
  "data": {
    "id": "45fa16aa-2546-49b3-9d1e-7b7e1c9fb1e7",
    "workspaceId": "9df81bd4-3d76-42cc-9518-a019ea75a221",
    "accountId": "0e35f7a8-e866-4f5d-b9cb-06961a130fef",
    "status": "active",
    "firstName": "Mina",
    "lastName": "Park",
    "displayName": "Mina Park",
    "email": "mina@acme.com",
    "jobTitle": "Head of Partnerships",
    "department": "Partnerships",
    "avatarUrl": "https://example.com/mina.jpg",
    "profileUrl": "https://tapify.app/mina-park",
    "slug": "mina-park",
    "contact": {
      "phone": "+31612345678",
      "whatsapp": "<string>",
      "website": "https://acme.com"
    },
    "contactDetails": [
      {
        "id": "33d5f285-64f7-41aa-bf9e-17a0fbf535af",
        "type": "phone",
        "label": "Mobile",
        "value": "+31612345678",
        "platform": "facebook",
        "address": {
          "line1": "Keizersgracht 391 A",
          "line2": "",
          "city": "Amsterdam",
          "postalCode": "1016 EJ",
          "country": "NL"
        }
      }
    ],
    "createdAt": "2026-07-01T09:30:00.000Z",
    "updatedAt": "2026-07-28T10:15:00.000Z",
    "created": true
  }
}

{
  "data": {
    "id": "45fa16aa-2546-49b3-9d1e-7b7e1c9fb1e7",
    "workspaceId": "9df81bd4-3d76-42cc-9518-a019ea75a221",
    "accountId": "0e35f7a8-e866-4f5d-b9cb-06961a130fef",
    "status": "active",
    "firstName": "Mina",
    "lastName": "Park",
    "displayName": "Mina Park",
    "email": "mina@acme.com",
    "jobTitle": "Head of Partnerships",
    "department": "Partnerships",
    "avatarUrl": "https://example.com/mina.jpg",
    "profileUrl": "https://tapify.app/mina-park",
    "slug": "mina-park",
    "contact": {
      "phone": "+31612345678",
      "whatsapp": "<string>",
      "website": "https://acme.com"
    },
    "contactDetails": [
      {
        "id": "33d5f285-64f7-41aa-bf9e-17a0fbf535af",
        "type": "phone",
        "label": "Mobile",
        "value": "+31612345678",
        "platform": "facebook",
        "address": {
          "line1": "Keizersgracht 391 A",
          "line2": "",
          "city": "Amsterdam",
          "postalCode": "1016 EJ",
          "country": "NL"
        }
      }
    ],
    "createdAt": "2026-07-01T09:30:00.000Z",
    "updatedAt": "2026-07-28T10:15:00.000Z",
    "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": "conflict",
    "message": "This email is already in use."
  }
}

{
  "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."
  }
}

Voeg een teamlid toe aan de workspace die bij je API-sleutel hoort. Stuur firstName, lastName en een geldig email mee. Je kunt ook een functie, afdeling, foto-URL en contactgegevens toevoegen. Het antwoord bevat de id, profileUrl en created van het teamlid:

Antwoord	Betekenis
`201` met `created: true`	Er zijn een nieuw teamlid en een digitaal visitekaartje aangemaakt.
`200` met `created: false`	Het e-mailadres hoort al bij een teamlid in deze workspace. Het bestaande teamlid wordt ongewijzigd teruggegeven.

Als het e-mailadres al wordt gebruikt door een teamlid buiten deze workspace, geeft Tapify 409 Conflict terug. Gebruik Teamlid bijwerken om de gegevens van een bestaand teamlid te wijzigen.

E-mail en uitnodigingen

Het verplichte veld email is het e-mailadres waarmee het teamlid inlogt. Wil je een e-mailadres op het visitekaartje tonen? Voeg dan ook een e-mailitem toe aan contactDetails:

{
  "type": "email",
  "value": "mina@acme.com"
}

Nieuwe teamleden beginnen normaal met status: "not_invited". Een teamlid aanmaken verstuurt geen uitnodiging. Verstuur deze via Team in het dashboard zodra het visitekaartje klaar is. Het veld sendInvite wordt niet ondersteund. Teamleden uitnodigen

Nieuwe teamleden tellen al mee voor je factuur voordat ze de uitnodiging accepteren. Bekijk de facturatie van teamleden voordat je een grote medewerkerslijst importeert.

Autorisaties

Authorization

string

header

vereist

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

Body

application/json

Maak een teamlid aan of geef het bestaande teamlid in de workspace ongewijzigd terug als het inlogadres al bestaat. Uitnodigingen worden vanuit het dashboard verstuurd; sendInvite wordt niet ondersteund.

firstName

string

vereist

Voornaam van het teamlid.

Minimum string length: 1

Voorbeeld:

"Mina"

lastName

string

vereist

Achternaam van het teamlid.

Minimum string length: 1

Voorbeeld:

"Park"

string<email>

vereist

Inlogadres van het teamlid, ook gebruikt voor uitnodigingen en het controleren op dubbele teamleden. Voeg een email-item toe aan contactDetails om een e-mailadres op het visitekaartje te tonen.

Voorbeeld:

"mina@acme.com"

jobTitle

string | null

Voorbeeld:

"Head of Partnerships"

department

string | null

Voorbeeld:

"Partnerships"

avatarUrl

string<uri> | null

Voorbeeld:

"https://example.com/mina.jpg"

contactDetails

(Telefoon of website · object | E-mail · object | Sociale media · object | Adres · object)[]

Persoonlijke contactmethoden voor het visitekaartje van het teamlid. Gedeelde bedrijfsgegevens uit de brandkit zijn niet inbegrepen en worden niet gewijzigd.

Een contactmethode die op het digitale visitekaartje van het teamlid wordt getoond.

Telefoon of website
E-mail
Sociale media
Adres

Show child attributes

Respons

Bestaand teamlid ongewijzigd teruggegeven

data

object

vereist

Een teamlid van de Tapify Teams-workspace.

Show child attributes

Aan de slag

Workspace

Contacten

Teamleden

Zapier

Teamlid aanmaken

E-mail en uitnodigingen

Autorisaties

Body

Respons

​E-mail en uitnodigingen

Autorisaties

Body

Respons

E-mail en uitnodigingen