Invite someone

Emails an invite to join the account with a role; it stays open for 7 days. Inviting an address with an open or expired invite sends a fresh one (200 instead of 201). The person accepts it signed in with that address.

Request body

JSON, sent with Content-Type: application/json.

Example request

curl "https://snip.link/v1/members" \
  -X POST \
  -H "Authorization: Bearer $SNIP_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Example response

{
  "member": {
    "id": "2b7e9c41-5d3a-4f8e-a1c6-7e0d9b2f4a18",
    "email": "sam@example.com",
    "role": "editor",
    "status": "joined",
    "invited_at": "2026-10-20T12:00:00.000Z",
    "joined_at": "2026-10-20T12:14:09.000Z",
    "expires_at": null
  }
}

Response fields

Errors