Update Order

put https://{subdomain}.myclickfunnels.com/api/v2/orders/{id}

Update a specific order in the current workspace. External orders have different updateable fields than orders that have a regular payment processor like Payments AI. Updating shipping and billing address fields follow specific rules. Please refer to the API documentation for more information.

Responses

Response body

object

integer

required

ClickFunnels Order ID

public_id

string | null

ClickFunnels Order public ID

order_number

string | null

A sequential number for bookkeeping purposes increased by 1 for each new order in a workspace starting from #1001.

workspace_id

integer

required

ClickFunnels Workspace ID

contact_id

integer

required

The contact associated with the order.

live_mode

boolean | null

Indicates if the Order will use a live payment gateway and process real credit cards, or if it will use a test gateway and only process test cards.

total_amount

string | null

Total

currency

string

required

Currency

origination_channel_id

integer

required

Origination Channel ID

origination_channel_type

string | null

Origination Channel Type

shipping_address_first_name

string | null

The first name of the recipient's shipping address.

shipping_address_last_name

string | null

The last name of the recipient's shipping address.

shipping_address_organization_name

string | null

The organization name of the recipient's shipping address.

shipping_address_phone_number

string | null

The phone number of the recipient's shipping address.

shipping_address_street_one

string | null

The main street information of the shipping address, including the street name and number.

shipping_address_street_two

string | null

Additional street information for the shipping address, like entrance information and apartment numbers.

shipping_address_city

string | null

The city of the shipping address.

shipping_address_region

string | null

The region of the shipping address, like state or province.

shipping_address_country

string | null

The country of the shipping address.

shipping_address_postal_code

string | null

Postal Code

billing_address_street_one

string | null

The main street information of the billing address, including the street name and number.

billing_address_street_two

string | null

Additional street information of the billing address, like entrance information and apartment numbers.

billing_address_city

string | null

The city of the billing address.

billing_address_region

string | null

The region of the shipping address, like state or province.

billing_address_country

string | null

The billing address country.

billing_address_postal_code

string | null

Billing address postal (ZIP) code.

page_id

integer | null

Page ID

notes

string | null

Your internal note about the order. This will be visible in ClickFunnels admin orders-related sections.

in_trial

boolean | null

In Trial

billing_status

string | null

The billing status reflects the status of the invoice of an order.
Billing status can be one of the following for Payments AI orders: pending, draft, paid, unpaid, partially-refunded, refunded, voided, disputed, past-due.

For external orders, the billing status can be one of: pending, paid, unpaid, voided and refunded.

service_status

string | null

The service status reflects the activity state of the order. For subscriptions, it can control whether a subscription is ongoing, for example despite an irregular (unpaid) invoice status.

For orders with Payments AI as payment processor it can be one of the following:
pending, active, completed, churned, canceled, suspended, paused, abandoned

For external one-time orders the expected statuses are pending or completed.

order_type

string | null

Order Type

next_charge_at

string | null

Next Charge At

tax_amount

string | null

Tax Amount

trial_end_at

string | null

Trial End At

billing_payment_method_id

string | null

Payment Method

funnel_name

string | null

Funnel Name

tag_ids

array | null

Order Tags

tag_ids

discount_ids

array | null

Discounts

discount_ids

activated_at

string | null

Date Activated

workspace_sharing_id

string | null

Workspace Sharing ID

canceled_at

string | null

Order Canceled At

canceled_by

string | null

Order Canceled By

cancel_reason

string | null

The reason code for the cancelation, it is required when canceling an order.

Possible codes for Payments AI orders are:
did-not-use, did-not-want, missing-features, too-expensive, bugs-or-problems, other

cancel_description

string | null

A free-text description of the cancellation reason.

churned_at

string | null

Churned At

created_at

date-time | null

Date Ordered

updated_at

date-time | null

Date Updated

external_id

string | null

An external ID, e.g., a payment provider's ID or an ID managed by the client internally

payment_processor

string | null

The payment processor of the order. Currently, it can be one of payments_ai and external.

phone_number

string | null

Phone Number

page_name

string | null

Page Name. Want to filter by it? See our help guide on that topic.

origination_channel_name

string | null

Origination Channel Name

order_page

object | null

Page

integer

required

Page ID

public_id

string | null

Page Public ID

name

string

required

Page name of the editable page element. Want to filter by it? See our help guide on that topic.

contact

object

required

Contacts

integer

required

Contact ID

public_id

string | null

Contact public ID

workspace_id

integer

required

Workspace ID

anonymous

string | null

Anonymous

email_address

string | null

Email address

first_name

string | null

First name

last_name

string | null

Last name

phone_number

string | null

Phone number

time_zone

string | null

The human-readable time zone, usually set dynamically by the app for the contact, for example, during opt-in.
Read more about time zones and how to map them back to the TZ standard in our Time Zones guide..

uuid

string

required

UUID

unsubscribed_at

string | null

Unsubscribed

last_notification_email_sent_at

string | null

Last notification email sent

fb_url

string | null

Facebook URL

twitter_url

string | null

Twitter URL

instagram_url

string | null

Instagram URL

linkedin_url

string | null

Linkedin URL

website_url

string | null

Website URL

created_at

date-time | null

Date added

updated_at

date-time | null

Last updated

tags

object

integer

required

Tag ID

public_id

string | null

Tag public ID

name

string

required

Name

color

string

required

Color

applied_at

string | null

The datetime the tag was applied by creating a Contacts::AppliedTag that maps the tag to the contact.

custom_attributes

object

A dynamic key-value pair object where both the key and value are strings. Custom attributes are usually added to the contact when they submit forms that contain custom contact attributes. But you can also add them via the API using the modifying endpoints like Create/Update/Upsert Contact.

Has additional fields

avatar_image

object

Avatar Image

Has additional fields

contact_groups

array of objects | null

Contact Groups

contact_groups

object

integer

required

Group ID

public_id

string | null

Group Public ID

name

string

required

Name

workspace

object

required

Workspaces

integer

required

Workspace ID

public_id

string | null

Workspace public ID

team_id

integer

required

Team ID

name

string

required

Workspace name

subdomain

string

required

Subdomain

created_at

date-time | null

Added

updated_at

date-time | null

Updated

segments

array of objects | null

Segments

segments

object

integer

required

Segment ID

public_id

string | null

Segment public ID

name

string

required

Name

line_items

array of objects | null

Order Line Items

line_items

object

integer

required

Line item ID

public_id

string | null

Line item public ID

order_id

integer

required

Order ID

quantity

integer | null

Quantity

prorated

string | null

Prorate invoice

created_at

string | null

Added

updated_at

string | null

Updated

original_product

object

required

Product

products_price

object

required

Product Price

products_variant

object | null

Product Variant

previous_line_item

string | null

An additional field, only available in outgoing subscription.upgrade/subscription.downgrade webhooks. It enables you to identify the former line item which is otherwise removed from the regular subscription line items when an upgrade or downgrade happens. Thus you can see the data of the previously active subscription. This property will not appear in regular API requests, but only in the event of a subscription upgrade or downgrade.

affiliate

object | null

The affiliate who will receive a commission for the order

name

string

required

The name of the affiliate. Can be a combination of first name, last name and the affiliate email.

string | null

The email address of the affiliate.

referral_code

object | null

The referral code used to associate an order with an affiliate.

code

string

required

The referral code value visible by users. It must be unique and can contain only letters, numbers, hyphens, and underscores.

default

boolean | null

Whether this code is the default code for the affiliate.

Language

Credentials

Bearer

URL


xxxxxxxxxx
1
curl --request PUT \
2
     --url https://myworkspace.myclickfunnels.com/api/v2/orders/id \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'


xxxxxxxxxx
191
}
1
{
2
  "id": 31,
3
  "public_id": "ZnoAwv",
4
  "order_number": "205396",
5
  "workspace_id": 42000,
6
  "contact_id": 128,
7
  "live_mode": true,
8
  "total_amount": "123.00",
9
  "currency": "USD",
10
  "origination_channel_id": 35,
11
  "origination_channel_type": "User",
12
  "shipping_address_first_name": "Alejandro",
13
  "shipping_address_last_name": "Hermann",
14
  "shipping_address_organization_name": "Testing, Inc.",
15
  "shipping_address_phone_number": "+19053871234",
16
  "shipping_address_street_one": "85841 Noemi Forks",
17
  "shipping_address_street_two": "Apt. 863",
18
  "shipping_address_city": "Mooreview",
19
  "shipping_address_region": "WA",
20
  "shipping_address_country": "US",
21
  "shipping_address_postal_code": "71252",
22
  "billing_address_street_one": "58272 Willms Views",
23
  "billing_address_street_two": "Apt. 208",
24
  "billing_address_city": "Tyronhaven",
25
  "billing_address_region": "WA",

200OK

400Bad Request

401Unauthorized

404Not Found