Skip to main content
POST
/
admin
/
v1
/
networks
/
{network_id}
/
invites
Create a new invite and send an email to the intended recipient
curl --request POST \
  --url https://api.mn.co/admin/v1/networks/{network_id}/invites \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "recipient_email": "claude@example.com",
  "recipient_first_name": "Claude",
  "recipient_last_name": "Monet",
  "user_id": 123
}'
{
  "recipient_email": "claude@example.com",
  "recipient_first_name": "Claude",
  "recipient_last_name": "Monet",
  "id": "1234",
  "created_at": "2025-11-07T23:17:21+00:00",
  "updated_at": "2025-11-07T23:17:21+00:00",
  "user_id": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
network_id
required

The Network's unique integer ID, or subdomain Unique numeric network ID

Body

application/json

Submit results as JSON

Invites allow users and admins to invite new users to the network

​
recipient_email
string
required

The recipients email address

Example:

"claude@example.com"

​
recipient_first_name
string

The recipient's first name

Example:

"Claude"

​
recipient_last_name
string

The recipient's last name

Example:

"Monet"

​
user_id
integer

The ID of the user to record as the creator of the invite.

If not provided, defaults to the owner of the authored API key.

Response

Returns the newly created invite on success

Invites allow users and admins to invite new users to the network

​
recipient_email
string
required

The recipients email address

Example:

"claude@example.com"

​
recipient_first_name
string
required

The recipient's first name

Example:

"Claude"

​
recipient_last_name
string
required

The recipient's last name

Example:

"Monet"

​
id
integer
required

The record's integer ID

Example:

"1234"

​
created_at
string<date-time>
required

The date and time the record was created

Example:

"2025-11-07T23:17:21+00:00"

​
updated_at
string<date-time>
required

The date and time the record was last modified

Example:

"2025-11-07T23:17:21+00:00"

​
user_id
integer
required

The ID of the user that created the invitation