Teammitglied erstellen

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

Teammitglied erstellen

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

Füge ein Mitglied zum Workspace hinzu, zu dem dein API-Schlüssel gehört. Sende firstName, lastName und eine gültige email. Du kannst auch Position, Abteilung, Foto-URL und Kontaktdaten angeben. Die Antwort enthält id, profileUrl und created des Mitglieds:

Antwort	Bedeutung
`201` mit `created: true`	Ein neues Mitglied und eine digitale Visitenkarte wurden erstellt.
`200` mit `created: false`	Die E-Mail-Adresse gehört bereits zu einem Mitglied in diesem Workspace. Das bestehende Mitglied wird unverändert zurückgegeben.

Wenn die E-Mail-Adresse bereits von einem Mitglied außerhalb dieses Workspaces verwendet wird, liefert Tapify 409 Conflict. Mit Teammitglied aktualisieren änderst du die Daten eines bestehenden Mitglieds.

E-Mail und Einladungen

Das Pflichtfeld email ist die Anmeldeadresse des Mitglieds. Damit eine E-Mail-Adresse auf der Visitenkarte erscheint, füge auch einen E-Mail-Eintrag zu contactDetails hinzu:

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

Neue Mitglieder beginnen normalerweise mit status: "not_invited". Beim Erstellen wird keine Einladung verschickt. Versende sie im Dashboard unter Team, sobald die Visitenkarte fertig ist. Das Feld sendInvite wird nicht unterstützt. Mitglieder einladen

Neue Mitglieder werden bereits abgerechnet, bevor sie ihre Einladung annehmen. Prüfe die Mitgliederabrechnung, bevor du ein großes Mitarbeiterverzeichnis importierst.

Autorisierungen

Authorization

string

header

erforderlich

Unter Einstellungen → API-Schlüssel erstellter API-Schlüssel.

Body

application/json

Erstelle ein Mitglied oder gib das vorhandene Workspace-Mitglied unverändert zurück, wenn seine Anmelde-E-Mail-Adresse bereits vorhanden ist. Einladungen werden über das Dashboard gesendet; sendInvite wird nicht unterstützt.

firstName

string

erforderlich

Vorname des Mitglieds.

Minimum string length: 1

Beispiel:

"Mina"

lastName

string

erforderlich

Nachname des Mitglieds.

Minimum string length: 1

Beispiel:

"Park"

string<email>

erforderlich

Anmelde-E-Mail-Adresse des Mitglieds, die auch für Einladungen und die Prüfung auf Duplikate verwendet wird. Um eine E-Mail-Adresse auf der Karte anzuzeigen, füge in contactDetails einen Eintrag vom Typ email hinzu.

Beispiel:

"mina@acme.com"

jobTitle

string | null

Beispiel:

"Head of Partnerships"

department

string | null

Beispiel:

"Partnerships"

avatarUrl

string<uri> | null

Beispiel:

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

contactDetails

(Telefon oder Website · object | E-Mail-Adresse · object | Soziale Netzwerke · object | Adresse · object)[]

Persönliche Kontaktmöglichkeiten für die Karte des Mitglieds. Gemeinsame Unternehmensdaten aus dem Markendesign sind nicht enthalten und werden nicht geändert.

Eine Kontaktmöglichkeit, die auf der digitalen Visitenkarte des Mitglieds angezeigt wird.

Telefon oder Website
E-Mail-Adresse
Soziale Netzwerke
Adresse

Show child attributes

Antwort

Vorhandenes Teammitglied unverändert zurückgegeben

data

object

erforderlich

Ein Mitglied des Tapify-Teams-Workspaces.

Show child attributes

Erste Schritte

Workspace

Kontakte

Teammitglieder

Zapier

Teammitglied erstellen

E-Mail und Einladungen

Autorisierungen

Body

Antwort

​E-Mail und Einladungen

Autorisierungen

Body

Antwort

E-Mail und Einladungen