Add Custom Attributes to a Subscription

POST https://api.chartmogul.com/v1/subscriptions/{SUBSCRIPTION_UUID}/attributes/custom

Adds custom attributes to a given subscription or subscription set.

curl -X POST "https://api.chartmogul.com/v1/subscriptions/sub_d1c0c885-add0-48db-8fa9-0bdf5017d6b0/attributes/custom" \
     -u YOUR_API_KEY: \
     -H "Content-Type: application/json" \
     -d '{
            "custom": [
              {"type": "Boolean", "key": "pre_sold", "value": "true"},
              {"type": "String", "key": "renewal_owner", "value": "[email protected]"}
            ]
         }'
{
  "custom": {
    "pre_sold": true,
    "renewal_owner": "[email protected]"
  }
}

Subscription set custom attributes. Subscription custom attributes can be added to either subscriptions or subscription sets. For subscription sets, use /subscription_sets/{SUBSCRIPTION_SET_UUID}/attributes/custom as the URL.

If your subscriptions belong to a set, consider managing custom attributes at the set level. Set-level attributes are inherited by all subscriptions in the set and persist when subscriptions change (for example, on a plan switch).

Path parameters

subscription_uuid string required
The ChartMogul UUID of the subscription or subscription set. Both can be retrieved using the List Customer Subscriptions endpoint.

Body parameters

custom array(object) required

An array containing the custom attributes to add to the subscription or subscription set. If an attribute with the given key doesn’t exist for the account, it is created automatically. Each item must have a type, key, and value.

type string required

The data type of the custom attribute. Can be one of String, Integer, Decimal, Timestamp, or Boolean.

Supported data types and their accepted formats.

  • String – Accepts alphanumeric characters. Maximum of 255 characters allowed.
  • Integer – Accepts only numeric characters.
  • Decimal – Accepts floating point numbers.
  • Timestamp – In the ISO 8601 format.
  • Boolean – Can be one of TRUE, true, t, 1, FALSE, false, f, or 0.
key string required

The name of the custom attribute. Accepts alphanumeric characters and underscores. Must not contain a ..

value string required

The value of the custom attribute. Must be 255 characters or fewer. All values are string-encoded regardless of type.

Response

custom
A JSON object containing the custom attributes on this subscription or subscription set after adding.