POST
/
applications
/
{app}
/
groups
/
{group}
/
invites
curl --request POST \
  --url https://api.rownd.io/applications/{app}/groups/{group}/invites \
  --header 'Content-Type: application/json' \
  --header 'x-rownd-app-key: <api-key>' \
  --header 'x-rownd-app-secret: <api-key>' \
  --data '{
  "user_id": "user_ofr5pgvof4w6o94hgjg0urjy",
  "roles": [
    "admin"
  ],
  "redirect_url": "/somewhere/on/my/site#"
}'
{
  "link": "<string>",
  "invitation": {
    "id": "c92kd7td7z4myhu7z5y637cp",
    "group_id": "group_zjca79svvbqfeilwr8httcal",
    "roles": [
      "editor"
    ],
    "state": "pending",
    "email": "randy@foo.com",
    "phone": 19199993333,
    "user_id": "user_mni5316glfgwtgljboxrv2it",
    "user_lookup_value": "randy@foo.com",
    "redirect_url": "/somewhere/on/my/site#",
    "app_variant_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "created_by": "user_t6ftnnmw55pamuhfo9xvw0yl",
    "accepted_by": "user_vgzrk03xpenj6td8vwi9crh4",
    "ensured_user_id": "<string>"
  }
}

Authorizations

x-rownd-app-key
string
headerrequired

The publishable key of your application credentials. (more details)

x-rownd-app-secret
string
headerrequired

The private secret of your application credentials. (more details)

Path Parameters

app
string
required

Rownd application ID

group
string
required

Group ID

Body

application/json
roles
string[]
required

The roles into which a group member will be added upon invite acceptance (The first member invited to a group will always be created with the 'owner' role along with any additional roles specified)

email
string

The email of a Rownd user in the specified application. This property is mutually exclusive with user_id and email

phone
string

The phone number of a Rownd user in the specified application. This property is mutually exclusive with user_id and email

user_id
string

The ID of a Rownd user in the specified application. This property is mutually exclusive with phone and email

redirect_url
string

The relative or absolute path location to which a user will be directed after accepting the invite

app_variant_id
string

The ID of an application variant for which this invite should be created. When a user accepts this invite, they will be added to the group as a member and signed into this application variant. (Learn about variants here)

Response

200 - application/json
link
string

The invitation link. Your user will use this link to accept the invite. For now, you will need to send this link to your users. In the future, Rownd will automatically send out invites via email or SMS for you

invitation
object
List groupsRetrieve a group invite