> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dacard.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Invite a team member

> Invite a new member to a team. Sends an email with the accept link.

Invite a new member to a team. The invite is created with `status: pending` and a transactional email is sent. Recipients accept via [POST /api/teams/\[id\]/accept](https://docs.dacard.ai/api-reference/teams/accept-invite).

```bash theme={null}
curl -X POST https://app.dacard.ai/api/teams/tm_2x1B3y/invite \
  -H "Authorization: Bearer $DACARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "designer@acme.com",
    "role": "scorer",
    "functionScope": "design"
  }'
```

| Property | Value |
| - | - |
| **Auth** | Required |
| **Required scope** | Caller must be a team `admin` |
| **Plan limit** | 10 members per team max |
| **Idempotent** | No (sends a new email each time) |

## Body

| Field | Type | Required | Notes |
| - | - | - | - |
| `email` | string | yes | The invitee's email. |
| `role` | `admin` \| `scorer` \| `viewer` | no | Defaults to `scorer`. |
| `functionScope` | `strategy` \| `design` \| `development` \| `intelligence` \| `operations` \| `gtm` | no | Narrows the dimensions this member sees and scores. |

## Response

`201 Created`

```json theme={null}
{
  "member": {
    "id": "tmm_...",
    "teamId": "tm_2x1B3y",
    "email": "designer@acme.com",
    "role": "scorer",
    "functionScope": "design",
    "status": "pending"
  }
}
```

## Errors

| Status | Code | When |
| - | - | - |
| 400 | `email is required` | Body missing email. |
| 400 | `Invalid function scope` | Bad `functionScope`. |
| 401 | `AUTH_REQUIRED` | No session. |
| 403 | `Only team admins can invite members` | Caller is not admin. |
| 409 | `Team is at the 10-member limit` | Roster full. |
| 409 | `That email is already on the team` | Duplicate invite. |
| 500 | `INTERNAL_ERROR` | Write or email send failed. |

Side effects: audit log `team_member_invited`, PQL event `team_invite_sent`, transactional email via Resend.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.