Skip to main content
POST
Create team member
Add a member to the workspace connected to your API key. Send firstName, lastName, and a valid email. You can also include a job title, department, photo URL, and contact details. The response returns the member’s id, profileUrl, and created: If an email is already used by a member outside this workspace, Tapify returns 409 Conflict. Use Update team member to change an existing member’s details.

Email and invitations

The required email is the member’s sign-in address. To display an email on their card, also add an email item to contactDetails:
New members normally start with status: "not_invited". Creating a member does not send an invitation. Send it from Team in the dashboard when the card is ready. The sendInvite field is not supported. Invite members
New members count toward billing before they accept an invitation. Review member billing before importing a large directory.

Authorizations

Authorization
string
header
required

API key created under Settings → API keys.

Body

application/json

Create a member, or return the existing workspace member unchanged when their sign-in email is already present. Invitations are sent from the dashboard; sendInvite is not supported.

firstName
string
required

Member's first name.

Minimum string length: 1
Example:

"Mina"

lastName
string
required

Member's last name.

Minimum string length: 1
Example:

"Park"

email
string<email>
required

Member sign-in email, also used for invitation and duplicate checking. To show an email on the card, include an email item in contactDetails.

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)[]

Personal contact methods for the member card. This does not include or change shared brand-kit company details.

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

Response

Existing team member returned unchanged

data
object
required

A member of the Tapify Teams workspace.