POST /api/v1/invitations/acceptNo authentication required. Accepts the invitation identified by token and adds the invitee as a member of the organization.
If the invited email address does not belong to an existing user, you must supply name and password to create the account inline. These fields are ignored if the email already has an account.
Request body Full name for the new account. Required when the invited email does not belong to an existing user.
Password for the new account. Required when the invited email does not belong to an existing user.
Response The newly created membership record. UUID of the membership record.
The user associated with this membership. Show MemberUser properties
ISO 8601 datetime when the email was verified, or null.
The role assigned by the invitation. Machine-readable identifier.
Human-readable display name.
Permission strings granted by this role.
ISO 8601 timestamp when the membership was created.
ISO 8601 timestamp of the last update.
Errors Status When 400Token is missing, name or password is required for a new user but not provided, or the invitation has expired 401Token is invalid or already used 409The invitee is already a member of the organization
Example Accepting as an existing user:
curl -X POST http://localhost:8080/api/v1/invitations/accept \ -H "Content-Type: application/json" \ -d '{"token": "inv_tok_a1b2c3d4e5f67890abcdef1234567890"}'
Accepting as a new user:
curl -X POST http://localhost:8080/api/v1/invitations/accept \ -H "Content-Type: application/json" \ -d '{ "token": "inv_tok_a1b2c3d4e5f67890abcdef1234567890", "name": "Jane Smith", "password": "securepassword123" }'
{ "accepted" : true , "member" : { "id" : "m2b2c3d4-e5f6-7890-abcd-ef1234567890" , "user" : { "id" : "u2b2c3d4-e5f6-7890-abcd-ef1234567890" , "name" : "Jane Smith" , "email" : "[email protected] " , "email_verified_at" : null }, "role" : { "id" : "r1b2c3d4-e5f6-7890-abcd-ef1234567890" , "key" : "developer" , "name" : "Developer" , "is_system" : true , "permissions" : [ "flags.read" , "flags.write" ] }, "created_at" : "2026-03-21T10:30:00Z" , "updated_at" : "2026-03-21T10:30:00Z" } }