API referenceRevenue share
Attribute a customer to an agreement
PUT
This customer came from that agreement's partner. Attributions made through the API are active at once. Scope partner:commissions:write.
apiKey partner:commissions:writeheader
AuthorizationBearer <ab_…>An API key from Integrations → Connect AI assistants (MCP) → New access, bound to exactly one company. Each operation names the scope the key must carry.
Scope: partner:commissions:write
source*SourceMatch
^[a-z0-9][a-z0-9_-]{0,49}$external_ref*External RefMatch
^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,254}$AlphaCount-Version?stringThe API version to use. Default: the current one.
application/json- body
PUT /commission-attributions/by-ref/{source}/{ref}.
agreement_ref*Agreement RefMatch
^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,254}$customer*end_date?|nullstart_date*Start DateFormat
dateOK
application/json- response
agreement_id*Agreement Idagreement_name*string|nullconfirmed_at*|nullconflicts_with_id*string|nullcustomer_id*Customer Idcustomer_name*string|nullend_date*|nullexternal_ref*string|nullid*Idpartner_id*string|nullpartner_name*string|nullsource*Sourcesource_ref*string|nullstart_date*Start DateFormat
datestatus*StatusValue in
"proposed""active""ended""rejected"curl -X PUT 'https://app.alphacount.ai/api/partner/v1/commission-attributions/by-ref/string/string' \ -H 'Authorization: Bearer ab_...' \ -H 'Content-Type: application/json' \ -d '{ "agreement_ref": "lernlink-2026", "customer": { "external_ref": "org-1", "source": "alphalearn" }, "start_date": "2026-10-01"}'Example Response
{ "agreement_id": "00000000-0000-4000-8000-000000000002", "agreement_name": "lern.link GmbH", "confirmed_at": "2026-10-19T15:09:58.234062", "conflicts_with_id": null, "customer_id": "00000000-0000-4000-8000-000000000004", "customer_name": "Musterschule", "end_date": null, "external_ref": "org-1-lernlink", "id": "00000000-0000-4000-8000-000000000001", "partner_id": "00000000-0000-4000-8000-000000000003", "partner_name": "lern.link GmbH", "source": "api", "source_ref": "alphalearn:org-1-lernlink", "start_date": "2026-10-01", "status": "active"}