fastmon Docs
Organizations

Create Invite

Report an issue

Create an organization invite and send email.

Request Body:

  • email: Email address to invite
  • role: Role to assign (default: "member"). Inviting an "owner" requires the caller to be an owner of the org - or an owner of a partner org that manages it (the partner→customer ownership handoff). Otherwise a regular member could invite a second account as owner and escalate. "viewer" and "member" need no extra authority: neither grants more than the inviter already holds.

Sends an invitation email with a unique token that expires in 7 days.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API token generated from the fastmon dashboard (Account → API Token) or at organization level (fmo_…, one that outlives its creator). Send as Authorization: Bearer fm_... or paste the full token (including its prefix) into the Authorize dialog.

Path Parameters

org_id*Org Id
Formatuuid

Request Body

application/json
  1. body
email*Email

Address to invite.

Formatemail
role?Role

Role the invitation grants once accepted.

Default"member"
Value in"owner""member""viewer"

Response Body

Successful Response

application/json
  1. response
id*Id

Identifier of the invitation.

Formatuuid
email*Email

Address it was sent to.

role*Role

Role it grants.

Value in"owner""member""viewer"
invited_by_id*Invited By Id

Who sent it.

Formatuuid
created_at*Created At

When it was sent.

Formatdate-time
expires_at*Expires At

When it stops working.

Formatdate-time
POST
/organizations/{org_id}/invites
curl -X POST 'https://api.fastmon.eu/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/invites' \  -H 'Content-Type: application/json' \  -d '{  "email": "user@example.com"}'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "email": "string",  "role": "owner",  "invited_by_id": "08d43d3e-0d7e-4fdf-aff3-5cfad05ec29b",  "created_at": "2019-08-24T14:15:22Z",  "expires_at": "2019-08-24T14:15:22Z"}