Skip to content
Documentation

Send company revenue

PUT
/v1/public-api/company-revenue

Scope: revenue:write. The company is found by company_uuid, else external_id (its id in your system), else domain. The same Idempotency-Key with a different body returns 409.

Authorization

integrationKey
headerAuthorizationBearer <cf_sk_…>

Organization API key (cf_sk_…), created under Organization → API and automations → API keys and sent as Authorization: Bearer cf_sk_….

Header Parameters

Idempotency-Key*string
Lengthlength <= 200

Request Body

application/json
  1. body
company_uuid?string
Formatuuid
external_id?string
domain?string
source?string
Value in"api""stripe""iyzico"
mrr_minor?integer
Formatint64
Range0 <= value
currency?string
Match^[A-Za-z]{3}$
plan?string
Lengthlength <= 120
billing_status?string
Value in"none""trialing""active""past_due""canceled"
renewal_at?|

RFC 3339 time or YYYY-MM-DD date; null clears it.

lifetime_value_minor?integer
Formatint64
Range0 <= value
external_ref?string
Lengthlength <= 200

Response Body

OK

application/json
  1. response
success*true
Value intrue
data*
meta*
Example Request
curl -X PUT 'https://api.getclickfix.com/v1/public-api/company-revenue' \  -H 'Idempotency-Key: string' \  -H 'Content-Type: application/json' \  -d '{  "external_id": "F-77",  "source": "api",  "mrr_minor": 490000,  "currency": "TRY",  "plan": "pro",  "billing_status": "active",  "renewal_at": "2026-12-01T00:00:00Z",  "lifetime_value_minor": 5880000,  "external_ref": "sub_9f3k2"}'
Example Response
{  "success": true,  "data": {    "company_uuid": "0f9e8d7c-6b5a-4493-8271-605f4e3d2c1b",    "revenue": {      "mrr_minor": 490000,      "currency": "TRY",      "plan": "pro",      "billing_status": "active",      "renewal_at": "2026-12-01T00:00:00Z",      "lifetime_value_minor": 5880000,      "source": "api",      "external_ref": "sub_9f3k2",      "updated_at": "2026-11-11T09:30:00Z"    }  },  "meta": {    "request_id": "01JCK9ZQ3M8R2W7X5E4T1N0PAB"  }}