Skip to main content
POST
/
api
/
v1
/
invites
Create Invite
curl --request POST \
  --url https://api.athenahq.ai/api/v1/invites \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "type": "organization",
  "invite_method": "email",
  "email": "user@example.com",
  "role": "viewer",
  "website_id": "123e4567-e89b-12d3-a456-426614174000",
  "first_name": "John",
  "last_name": "Doe"
}
'
{
  "success": true,
  "message": "User added to organization"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. You can create one here.

Body

application/json

Request body for creating an invite

​
type
enum<string>
required

The type of invite - organization-level or website-specific access

Available options:
organization,
website
Example:

"organization"

​
invite_method
enum<string>
required

How to invite the user. Use 'direct' to add an existing user immediately, or 'email' to send an invitation email

Available options:
direct,
email
Example:

"email"

​
email
string<email>
required

Email address of the user to invite

Example:

"user@example.com"

​
role
enum<string>
default:viewer

The role to assign to the invited user

Available options:
admin,
viewer
Example:

"viewer"

​
website_id
string<uuid>

Required when type is 'website'. The ID of the website to grant access to

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
first_name
string

Optional first name of the invited user

Example:

"John"

​
last_name
string

Optional last name of the invited user

Example:

"Doe"

Response

User added or invitation sent successfully

Response from creating an invite

​
success
boolean
required

Whether the operation was successful

Example:

true

​
message
string
required

A message describing the result

Example:

"Invitation sent"

​
invite_id
string<uuid>

The ID of the created invite (only present for email invites)

Example:

"123e4567-e89b-12d3-a456-426614174000"