Creating a Billing Group

Billing Groups can be used to organize your Groups for the following purposes:

  • Segmenting reporting data
  • Restricting User access in the online portal
  • Customization of rate card (speak to your customer success representative for additional details)

Your billing groups may be organized into a hierarchy up to 3 levels (the depth of the hierarchy is defined during the organization setup phase - consult with your customer success representative for more information).

Please note that Groups may only be assigned to leaf nodes of your Billing Group hierarchy.

Using the POST method with the Billing Groups will create a new Billing Group

POST https://edgeapi.marchex.io/marketingedge/v5/api/billinggroups/{parent_id}
Please note that your organization will have at least one Billing Group created as part of the account creation process

The following sample request can be used to create a Billing Group

curl -H "x-organization-token: {authorization_token}" \
 			-H "subscription-key: {subscription_key}" \
     	-X POST \
     	"https://edgeapi.marchex.io/marketingedge/v5/api/billinggroups/9231" \
     	-d '{
            "billing_group_name": "Sales",
            "status": "active"         
			}'

If the request is handled successfully, the following response will be returned:

{
  "billing_group_name": "Sales",
  "billing_group_id": 9325,
  "status": "active"
}