Skip to main content

Send group sharing-requests

POST 
/v1/groups/:groupId/sharing-requests

Creates a new sharing request for a user to join the group. The invitee is named by username — the email address or E.164 phone number they sign in with. The user will see this in their 'sharing-requests' inbox.

username may be omitted to create a QR-code sharing request instead: the response's request_id is meant to be encoded into a QR code and claimed by whoever scans it, via POST /v1/sharing-requests/{requestId}/accept. The invite is single-use: the first accept or reject spends it, and the sharer takes it back by rejecting it themselves.

A request expires if nobody acts on it: 24 hours for a named invitee, 7 days for a QR-code request, which has to survive being printed or passed around rather than sitting in an inbox. Acting on an expired request answers 410.

Request​

Responses​

Invitation sent successfully