API Reference
Advancehq.com

Create new plan

post
https://api.advancehq.com/v1/plans

Creates a new plan. Payment link is created and invoice PDF is generated.

Body Params

Request body for creating a new plan via the public API. All plans created via the public API are immediately set to open status.

agency_fees
array of objects | null
deprecated

DEPRECATED: Use per-policy agency fees instead. Kept for backward compatibility only.

Agency Fees
allowed_payment_methods
array of objects | null

Payment methods to accept. Online checkout methods are 'checkout_ach' and 'checkout_credit_card'; offline methods are 'ach' (manual bank transfer) and 'check'. If you omit any checkout_* method, both online methods are enabled by default. To offer only one online method, pass just that value (e.g. ['checkout_credit_card']). Add 'ach' or 'check' to also accept manually-recorded offline payments.

Allowed Payment Methods
Allowed:
string
enum
Defaults to direct
Allowed:
cc_emails
array of strings | null

Additional email addresses to CC the invoice file.

Cc Emails
string | null

ID of an existing insured record. If provided, recipient fields are populated from the insured.

string | null
Defaults to Invoice

Header text shown at the top of the invoice. Defaults to 'Invoice'.

string | null

Free-text notes displayed on the invoice, visible to the recipient.

string | null
date-time | null

Payment due date (ISO 8601). Used to trigger overdue status and reminder notifications.

policies
array of objects | null

List of insurance policies to include on this plan. Each policy requires at least a carrier_id.

Policies
string | null

ID of the producer associated with this plan. Required for commission tracking.

string | null

Email address where the invoice is delivered. Required for email delivery.

string | null

Display name of the person or company receiving the invoice.

string | null

Recipient phone number (max 20 characters).

reminder_days
array of integers | null

List of days before (-) or after (+) payment due date to send reminders. Max 4 reminders.

Reminder Days
string | null

Email shown as the sender on the invoice.

string | null

Name shown as the sender on the invoice. Defaults to the agency name.

surplus_fees_lines
array of objects | null
deprecated

DEPRECATED: Use per-policy surplus fee lines instead. Kept for backward compatibility only.

Surplus Fees Lines
surplus_tax_lines
array of objects | null
deprecated

DEPRECATED: Use per-policy surplus tax lines instead. Kept for backward compatibility only.

Surplus Tax Lines
surplus_taxes
object
deprecated

DEPRECATED: Use per-policy surplus taxes instead. Kept for backward compatibility only.

boolean | null
Defaults to false
Responses

Updated about 2 months ago

Did this page help you?
Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago

Did this page help you?