Create account

Use this endpoint to create a new Account under your Company. Use this when you need to programmatically set up a new team, department, or budget owner with its own campaigns and billing method.

Required fields:

• name - display name of the Account
• billingMethod - the initial billing method to attach to the Account
  • billingMethod.type - currently must be INV (invoice). Other billing types (Prepay, PO, CC) must be set up via the Snappy Dashboard.
  • billingMethod.amount - billing amount
  • billingMethod.name - display name of the billing method

Optional parameters:

• Snappy-Account-Id header - optional account scoping
• Snappy-Company-Id header - optional company scoping

Behavior Notes:

• Returns 201 with the new Account details wrapped in { data: { id, name, createdAt, updatedAt, companyId } } on success.
• Returns 409 when an Account with the same name already exists in the Company.
• Returns 422 for business-rule violations (e.g. invalid billing configuration).
• Currently only invoice (INV) billing methods can be created via the API. To set up Prepay, PO, or Credit Card billing, create the Account first and then configure billing via the Snappy Dashboard.

Permissions

• Requires: accounts:create