Invitations allow you to invite someone to sign up to your application, via email.
Creates a new invitation for the given email address and sends the invitation email. Keep in mind that you cannot create an invitation if there is already one for the given email address. Also, trying to create an invitation for an email address that already exists in your application will result to an error.
Required parameters
email_address required | string The email address the invitation will be sent to |
public_metadata | object Metadata that will be attached to the newly created invitation. The value of this property should be a well-formed JSON object. Once the user accepts the invitation and signs up, these metadata will end up in the user's public metadata. |
redirect_url | string Optional URL which specifies where to redirect the user once they click the invitation link. This is only required if you have implemented a custom flow and you're not using Clerk Hosted Pages or Clerk Components. |
notify | boolean or null Default: true Optional flag which denotes whether an email invitation should be sent to the given email address. Defaults to true. |
ignore_existing | boolean or null Default: false Whether an invitation should be created if there is already an existing invitation for this email address, or it's claimed by another user. |
Success
Request was not successful
Invalid request parameters
{- "email_address": "string",
- "public_metadata": { },
- "redirect_url": "string",
- "notify": true,
- "ignore_existing": false
}
{- "object": "invitation",
- "id": "string",
- "email_address": "user@example.com",
- "public_metadata": { },
- "revoked": false,
- "status": "pending",
- "url": "string",
- "created_at": 0,
- "updated_at": 0
}
Returns all non-revoked invitations for your application, sorted by creation date
List of invitations
[- {
- "object": "invitation",
- "id": "string",
- "email_address": "user@example.com",
- "public_metadata": { },
- "revoked": false,
- "status": "pending",
- "url": "string",
- "created_at": 0,
- "updated_at": 0
}
]
Revokes the given invitation. Revoking an invitation will prevent the user from using the invitation link that was sent to them. However, it doesn't prevent the user from signing up if they follow the sign up flow. Only active (i.e. non-revoked) invitations can be revoked.
Success
Request was not successful
Resource not found
{- "object": "invitation",
- "id": "string",
- "email_address": "user@example.com",
- "public_metadata": { },
- "revoked": true,
- "status": "revoked",
- "url": "string",
- "created_at": 0,
- "updated_at": 0
}