Upsert brand billing profile

Billing profile created or updated.

PUT /v1/brands/{brand_id}/billing

cURL

curl --request PUT \
  --url 'https://api.workstream.stateset.com/v1/brands/{brand_id}/billing' \
  --header "x-api-key: $STATESET_TEMPORAL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "string",
  "billing_org_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "stripe_customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "stripe_subscription_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "billing_email": "string",
  "pricing_model": "string",
  "default_currency": "USD",
  "meter_event_namespace": "string",
  "meter_event_overrides": {},
  "enabled": true,
  "metadata": {}
}'

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "brand_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "provider": "string",
  "billing_org_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "stripe_customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "stripe_subscription_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "billing_email": "string",
  "pricing_model": "string",
  "default_currency": "USD",
  "meter_event_namespace": "string",
  "meter_event_overrides": {},
  "enabled": true,
  "metadata": {},
  "created_at": "2026-08-31T14:22:05Z",
  "updated_at": "2026-08-31T14:22:05Z"
}

Path parameters

brand_id · string (uuid) · required

Request body

object

provider · string

billing_org_id · string

stripe_customer_id · string

stripe_subscription_id · string

billing_email · string

pricing_model · string

default_currency · string

meter_event_namespace · string

meter_event_overrides · object

enabled · boolean

metadata · object

Response

object

id · string (uuid) · required

brand_id · string (uuid) · required

tenant_id · string (uuid) · required

provider · string · required

billing_org_id · string

stripe_customer_id · string

stripe_subscription_id · string

billing_email · string

pricing_model · string · required

default_currency · string · required

meter_event_namespace · string · required

meter_event_overrides · object · required

enabled · boolean · required

metadata · object · required

created_at · string (date-time) · required

updated_at · string (date-time) · required

Status codes

Code	Meaning
200	Billing profile created or updated.
400	Validation error
401	Unauthorized
404	Not found
429	Rate limited
500	Internal error

cURL

curl --request PUT \
  --url 'https://api.workstream.stateset.com/v1/brands/{brand_id}/billing' \
  --header "x-api-key: $STATESET_TEMPORAL_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "string",
  "billing_org_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "stripe_customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "stripe_subscription_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "billing_email": "string",
  "pricing_model": "string",
  "default_currency": "USD",
  "meter_event_namespace": "string",
  "meter_event_overrides": {},
  "enabled": true,
  "metadata": {}
}'

200

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "brand_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "tenant_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "provider": "string",
  "billing_org_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "stripe_customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "stripe_subscription_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "billing_email": "string",
  "pricing_model": "string",
  "default_currency": "USD",
  "meter_event_namespace": "string",
  "meter_event_overrides": {},
  "enabled": true,
  "metadata": {},
  "created_at": "2026-08-31T14:22:05Z",
  "updated_at": "2026-08-31T14:22:05Z"
}