# Invitations

Invite users into the sub-clients of your hierarchy. Each invitation creates (or resends to) a
user in the target sub-client and emails them an acceptance link they follow to set a password
and finish signing up.

Invitations may only be issued into sub-clients of the authenticated client — never into the
authenticated client itself. Users of your own organization are managed through the SQUAKE
Dashboard.

Requires this feature to be enabled for your account (contact us); otherwise every
`/v2/invitations` endpoint responds with `404`.


## Invite a User

 - [POST /v2/invitations](https://docs-v2.squake.earth/docs/openapi/invitations/post-v2-invitations.md): Invites a user to one of the authenticated client's sub-clients. The user is created if they don't already exist, or reused if the 
email address already belongs to a user of that sub-client. An invitation email is then queued.

This endpoint only supports sub-clients:  must refer to a sub-client of the authenticated client. You can't invite users 
to the authenticated client itself. Omitting  also targets the authenticated client (as it does elsewhere in v2), so both 
cases return  (). To manage users in your own organization, use the SQUAKE Dashboard.

Re-inviting the same email address for the same sub-client is safe. The existing invitation is returned with an updated , 
and the email is sent again. The acceptance URL stays the same, so any previously sent invitation link will continue to work. If
 is omitted when re-inviting a user, the locale from the previous invitation is preserved.


## Retrieve an Invitation

 - [GET /v2/invitations/{id}](https://docs-v2.squake.earth/docs/openapi/invitations/get-v2-invitations-id.md): Returns an invitation by id. You can read invitations belonging to the authenticated client or any of its descendants. 
Invitations outside your hierarchy are treated the same as invitations that don’t exist, so both return not_found (404).

Use this to check whether an invitation has been accepted (accepted_at) or to retrieve its acceptance URL again.