---
title: "Accept an invitation"
method: POST
path: "/api/v1/members/invites/{token}/accept"
tags: ["members"]
---

# Accept an invitation

`POST /api/v1/members/invites/{token}/accept`

Completes an invitation and returns the new member's API key. Requires a verification code issued by Create an account for the *invited* address — a code issued for any other address is rejected. Unauthenticated: the token plus the emailed code are the credentials. No new account is created and no phone number is provisioned; the caller joins the inviting account.

## Path parameters

- `token` string, required

## Request body

- AcceptMemberInviteRequest
  - `verificationId` string, required — The `verificationId` returned by Create an account for the invited address.
  - `code` string, required — The 6-digit code emailed to the invited address.

## Response `200`

The invitation was accepted. The API key is shown once — store it.

- MembersAcceptMemberInviteResponse200
  - `accountId` string, required — The account the caller has joined.
  - `apiKey` string, required — The member's own API key. Shown once.
  - `member` AccountMember, required
    - `id` string, nullable, required — The membership id, used to remove the member. Always `null` for the owner, who is the account's own email address and cannot be removed.
    - `email` string, email, required
    - `role` 'owner' | 'member', required
    - `status` 'pending' | 'active', required — `pending` until the invitation is accepted. A pending member has no API key and no access. The owner is always `active`.
    - `invitedByEmail` string, email, nullable — Who sent the invitation. Null for the owner.
    - `invitedAt` string, date-time, nullable
    - `acceptedAt` string, date-time, nullable — When the invitation was accepted, or null while pending.
    - `lastActiveAt` string, date-time, nullable — When this member's API key was last used, or null if never used.

## Other responses

- `400` — The request body failed validation.
- `401` — The verification code is invalid, expired, already used, or was issued for a different address.
- `404` — The token is unknown, already accepted, or expired.

---

[API](https://skmtc.net/getdial/apis/rest-api.md) · [All operations](https://skmtc.net/getdial/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getdial/rest-api/versions/cfa621230237/schema)