Skip to content
Space Invoices Documentation

Entity Invitations

Entity Invitations

Manage entity user invitations - list, accept, cancel, resend.

Endpoints
IntroductionPOST/invitations/acceptGET/entities/invitationsGET/entities/invitations/{id}DELETE/entities/invitations/{id}GET/invitations/previewPOST/entities/invitations/{id}/resend

The Entity Invitation object

object

Attributes

idstring

Invitation ID

emailstring

Invitee email

rolestring

User role on the entity

Possible values: "viewer", "editor", "admin"

statusstring

Current status of the invitation

Possible values: "pending", "accepted", "expired"

expires_atstring<date-time>

When the invitation expires

Other attributes
entity_idstring
invited_by_user_idstring
accepted_atstring<date-time>nullable
created_atstring<date-time>
Examplejson
{
  "id": "einv_abc123def456789012345678",
  "entity_id": "ent_abc123def456",
  "email": "newuser@example.com",
  "name": "John Doe",
  "role": "editor",
  "status": "pending",
  "invited_by": "user_xyz789",
  "expires_at": "2024-01-08T00:00:00.000Z",
  "created_at": "2024-01-01T00:00:00.000Z",
  "updated_at": "2024-01-01T00:00:00.000Z"
}

Accept invitation

POST/invitations/accept

Accept an entity invitation by providing user details. Creates or links a white-label user for the invited entity account and grants entity access. Returns an access token for immediate use.

Request

Query parameters

tokenstringrequired

Invitation token from the invitation email

Body parameters

passwordstringrequired

Password for the new user account, or current password for an existing invited user

Other parameters
namestringoptional
curl -X POST "https://eu.spaceinvoices.com/invitations/accept?token=2026-12-31" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "password": "string"
  }'
Response

Returns

messagestring
user_idstring
entity_idstring
access_tokenstring
json
{
  "user_id": "user_abc123",
  "entity_id": "ent_xyz789",
  "access_token": "token_live_abc123"
}

List entity invitations

GET/entities/invitations

Retrieve all invitations for the current entity, including pending, accepted, and expired.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

curl "https://eu.spaceinvoices.com/entities/invitations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"
Response

Returns

dataarray of objects
json
{
  "data": [
    {
      "id": "einv_abc123def456789012345678",
      "entity_id": "ent_abc123def456",
      "email": "newuser@example.com",
      "name": "John Doe",
      "role": "editor",
      "status": "pending",
      "invited_by": "user_xyz789",
      "expires_at": "2024-01-08T00:00:00.000Z",
      "created_at": "2024-01-01T00:00:00.000Z",
      "updated_at": "2024-01-01T00:00:00.000Z"
    }
  ]
}

Get entity invitation

GET/entities/invitations/{id}

Retrieve details of a specific invitation.

Request

Header parameters

entity_idstringoptional

Optional entity ID specifying which entity context to use for this operation.

Path parameters

idstring<resource-id>required

Space Invoices resource identifier (format: {prefix}_{hex24})

curl "https://eu.spaceinvoices.com/entities/invitations/{id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"
Response

Returns

idstring

Invitation ID

emailstring

Invitee email

Other parameters
entity_idstring
rolestring
invited_by_user_idstring
expires_atstring<date-time>
accepted_atstring<date-time>nullable
statusstring
created_atstring<date-time>
json
{
  "id": "einv_abc123def456789012345678",
  "entity_id": "ent_abc123def456",
  "email": "newuser@example.com",
  "name": "John Doe",
  "role": "editor",
  "status": "pending",
  "invited_by": "user_xyz789",
  "expires_at": "2024-01-08T00:00:00.000Z",
  "created_at": "2024-01-01T00:00:00.000Z",
  "updated_at": "2024-01-01T00:00:00.000Z"
}

Cancel invitation

DELETE/entities/invitations/{id}

Cancel a pending invitation. Cannot cancel already accepted invitations.

Request

Header parameters

entity_idstringoptional

Optional entity ID specifying which entity context to use for this operation.

Path parameters

idstring<resource-id>required

Space Invoices resource identifier (format: {prefix}_{hex24})

curl -X DELETE "https://eu.spaceinvoices.com/entities/invitations/{id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"
Response

Returns

messagestring
json
{
  "message": "Invitation cancelled"
}

Preview invitation

GET/invitations/preview

Preview an entity invitation by token before accepting it.

Request

Query parameters

tokenstringrequired

Invitation token from the invitation email

curl "https://eu.spaceinvoices.com/invitations/preview?token=2026-12-31" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"
Response

Returns

emailstring<email>
entity_namestring
existing_userboolean
rolestring
statusstring
expires_atstring<date-time>
json
{
  "email": "string",
  "entity_name": "string",
  "existing_user": true,
  "role": "viewer",
  "status": "pending",
  "expires_at": "2025-01-15T10:30:00.000Z"
}

Resend invitation

POST/entities/invitations/{id}/resend

Resend an invitation email with a new token and extended expiry.

Request

Header parameters

entity_idstringoptional

Optional entity ID specifying which entity context to use for this operation.

Path parameters

idstring<resource-id>required

Space Invoices resource identifier (format: {prefix}_{hex24})

curl -X POST "https://eu.spaceinvoices.com/entities/invitations/{id}/resend" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"
Response

Returns

messagestring
expires_atstring<date-time>
json
{
  "message": "Invitation resent"
}