Create team member

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",
        "label": "Mobile",
        "value": "+31612345678",
        "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",
        "label": "Mobile",
        "value": "+31612345678",
        "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": "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": {}
  }
}

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

POST

team-members

Create team member

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",
        "label": "Mobile",
        "value": "+31612345678",
        "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",
        "label": "Mobile",
        "value": "+31612345678",
        "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": "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": {}
  }
}

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

Send the member’s first name, last name, and work email. Tapify creates their digital business card and adds them with the status not_invited (Not invited). If the email already belongs to a member in this workspace, Tapify returns the existing member unchanged. The response contains created: false. Use Update team member to change their details. The API does not send invitations. When the digital business card is ready, open Team in the Tapify dashboard and send the invitation.

Creating a new member can increase the workspace’s billed member count. See Billing and trial before syncing a large directory.

Authorizations

Authorization

string

header

required

API key created under Settings → API keys.

Body

application/json

Details for a new team member. If the email already exists in the workspace, Tapify returns that member unchanged.

firstName

string

required

Member's first name.

Example:

"Mina"

lastName

string

required

Member's last name.

Example:

"Park"

string<email>

required

Work email used for activation and duplicate checking.

Example:

"mina@acme.com"

jobTitle

string | null

Example:

"Head of Partnerships"

department

string | null

Example:

"Partnerships"

avatarUrl

string<uri> | null

Example:

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

contactDetails

(Phone or website · object | Email · object | Social media · object | Address · object)[]

Contact methods to show on the member's digital business card.

A contact method shown on the member's digital business card.

Phone or website
Email
Social media
Address

Show child attributes

Response

Existing team member returned unchanged

data

object

required

A member of the Tapify Teams workspace.

Show child attributes

Getting started

Workspace

Contacts

Team members

Create team member

Authorizations

Body

Response