fastmon Docs
Partners

Create Client

Report an issue

Create a brand-new organization and link it to this partner as a client.

Requires direct membership of the partner org at member level or above, and the org must carry the partner entitlement (is_partner).

Unlike POST /admin/partners (which links an existing org and is admin-only), this lets a partner self-provision client orgs. By default the new org gets no direct member - it is managed through partner access until a real customer takes ownership. Pass owner_email to invite that customer as OWNER in the same step (an invite email is sent; on accept they become owner).

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

Create a new organization and link it to this partner as a client.

Self-service counterpart to the admin-only link endpoint (POST /admin/partners, which attaches an existing org).

name*Name

Name of the new client organization

Length1 <= length <= 128
billing?Billing

Whether this partner pays for the client. Without covered_features and included_pageviews true covers what the contract allows and false covers nothing. Each of the two given replaces that default.

Defaultfalse
covered_features?array<>|

The features this partner covers for the client, within its contract.

included_pageviews?|

The pageviews per month this partner covers for the client, within its contract. null for unlimited, allowed only while the contract is unlimited.

owner_email?|

Optional: invite this email as OWNER of the new client org. Sends an invite email; on accept the customer takes ownership. Omit to keep the org partner-managed (headless).

Response Body

Successful Response

application/json
  1. response

A partner-client relationship.

id*Id
Formatuuid
partner_org_id*Partner Org Id
Formatuuid
client_org_id*Client Org Id
Formatuuid
client_org_name*Client Org Name
billing*Billing

Whether this partner pays for the client: it covers a feature or pageviews.

covered_features*array<>

The features this partner covers for the client, capped by its contract.

included_pageviews?Included Pageviews

The pageviews per month this partner covers for the client, capped by its contract. Absent where unlimited.

created_at*Created At
Formatdate-time
POST
/organizations/{org_id}/partner/clients
curl -X POST 'https://api.fastmon.eu/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/partner/clients' \  -H 'Content-Type: application/json' \  -d '{  "name": "string"}'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "partner_org_id": "6d083317-c55a-4f41-82ae-8c86d8187f47",  "client_org_id": "9aa3dfe7-3f4d-43e2-a858-0015d7ac15be",  "client_org_name": "string",  "billing": true,  "covered_features": [    "checkout"  ],  "included_pageviews": 0,  "created_at": "2019-08-24T14:15:22Z"}