> For the complete documentation index, see [llms.txt](https://docs.partssource.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.partssource.com/webhooks-customer/preview/event-reference.md).

# Event Reference

{% hint style="warning" %}
**Preview** — this page describes the upcoming release (early September). For what is in production today, switch to the **Current** variant.
{% endhint %}

{% hint style="info" %}
This reference is generated from the webhook OpenAPI specification. Event availability and integration guidance live in the Overview.
{% endhint %}

### Order lifecycle

{% openapi-webhook spec="customer-webhooks-preview" name="customer.order.line.created" method="post" %}
[customer-webhooks-preview](https://gist.githubusercontent.com/bkuleta-ps/33c4db3af537bdac620644c78c70e988/raw/customer-webhooks-v1.json)
{% endopenapi-webhook %}

{% openapi-webhook spec="customer-webhooks-preview" name="customer.order.line.backorder.created" method="post" %}
[customer-webhooks-preview](https://gist.githubusercontent.com/bkuleta-ps/33c4db3af537bdac620644c78c70e988/raw/customer-webhooks-v1.json)
{% endopenapi-webhook %}

{% openapi-webhook spec="customer-webhooks-preview" name="customer.order.line.backorder.updated" method="post" %}
[customer-webhooks-preview](https://gist.githubusercontent.com/bkuleta-ps/33c4db3af537bdac620644c78c70e988/raw/customer-webhooks-v1.json)
{% endopenapi-webhook %}

{% openapi-webhook spec="customer-webhooks-preview" name="customer.order.line.cancelled" method="post" %}
[customer-webhooks-preview](https://gist.githubusercontent.com/bkuleta-ps/33c4db3af537bdac620644c78c70e988/raw/customer-webhooks-v1.json)
{% endopenapi-webhook %}

### Approvals

{% openapi-webhook spec="customer-webhooks-preview" name="customer.order.line.approval.requested" method="post" %}
[customer-webhooks-preview](https://gist.githubusercontent.com/bkuleta-ps/33c4db3af537bdac620644c78c70e988/raw/customer-webhooks-v1.json)
{% endopenapi-webhook %}

{% openapi-webhook spec="customer-webhooks-preview" name="customer.order.line.approval.approved" method="post" %}
[customer-webhooks-preview](https://gist.githubusercontent.com/bkuleta-ps/33c4db3af537bdac620644c78c70e988/raw/customer-webhooks-v1.json)
{% endopenapi-webhook %}

{% openapi-webhook spec="customer-webhooks-preview" name="customer.order.line.approval.rejected" method="post" %}
[customer-webhooks-preview](https://gist.githubusercontent.com/bkuleta-ps/33c4db3af537bdac620644c78c70e988/raw/customer-webhooks-v1.json)
{% endopenapi-webhook %}

{% openapi-webhook spec="customer-webhooks-preview" name="customer.order.line.approval.completed" method="post" %}
[customer-webhooks-preview](https://gist.githubusercontent.com/bkuleta-ps/33c4db3af537bdac620644c78c70e988/raw/customer-webhooks-v1.json)
{% endopenapi-webhook %}

### Shipments

{% openapi-webhook spec="customer-webhooks-preview" name="customer.shipment.shipped" method="post" %}
[customer-webhooks-preview](https://gist.githubusercontent.com/bkuleta-ps/33c4db3af537bdac620644c78c70e988/raw/customer-webhooks-v1.json)
{% endopenapi-webhook %}

{% openapi-webhook spec="customer-webhooks-preview" name="customer.shipment.tracking.assigned" method="post" %}
[customer-webhooks-preview](https://gist.githubusercontent.com/bkuleta-ps/33c4db3af537bdac620644c78c70e988/raw/customer-webhooks-v1.json)
{% endopenapi-webhook %}

{% openapi-webhook spec="customer-webhooks-preview" name="customer.shipment.estimated\_ship\_date.created" method="post" %}
[customer-webhooks-preview](https://gist.githubusercontent.com/bkuleta-ps/33c4db3af537bdac620644c78c70e988/raw/customer-webhooks-v1.json)
{% endopenapi-webhook %}

{% openapi-webhook spec="customer-webhooks-preview" name="customer.shipment.estimated\_ship\_date.updated" method="post" %}
[customer-webhooks-preview](https://gist.githubusercontent.com/bkuleta-ps/33c4db3af537bdac620644c78c70e988/raw/customer-webhooks-v1.json)
{% endopenapi-webhook %}

### Deprecated events

{% hint style="warning" %}
The two events below are deprecated — migrate to `customer.shipment.estimated_ship_date.*`. See the deprecation policy in the Overview.
{% endhint %}

{% openapi-webhook spec="customer-webhooks-preview" name="order.line.estimated\_ship\_date.created" method="post" %}
[customer-webhooks-preview](https://gist.githubusercontent.com/bkuleta-ps/33c4db3af537bdac620644c78c70e988/raw/customer-webhooks-v1.json)
{% endopenapi-webhook %}

{% openapi-webhook spec="customer-webhooks-preview" name="order.line.estimated\_ship\_date.updated" method="post" %}
[customer-webhooks-preview](https://gist.githubusercontent.com/bkuleta-ps/33c4db3af537bdac620644c78c70e988/raw/customer-webhooks-v1.json)
{% endopenapi-webhook %}

### Shared objects

## The ShipAddress object

```json
{"openapi":"3.1.0","info":{"title":"Customer Webhooks","version":"v1"},"components":{"schemas":{"ShipAddress":{"type":"object","properties":{"ship_address_id":{"type":["integer","null"],"description":"Address identifier. Omitted when there is no value.","format":"int64"},"attention_to":{"type":["string","null"],"description":"Attention line. Omitted when there is no value."},"edi_sender_code":{"type":["string","null"],"description":"EDI sender code. Omitted when there is no value."},"address_1":{"type":["string","null"],"description":"Address line 1. Omitted when there is no value."},"address_2":{"type":["string","null"],"description":"Address line 2. Omitted when there is no value."},"address_3":{"type":["string","null"],"description":"Address line 3. Omitted when there is no value."},"city":{"type":["string","null"],"description":"City. Omitted when there is no value."},"state":{"type":["string","null"],"description":"State or province. Omitted when there is no value."},"zip_code":{"type":["string","null"],"description":"Postal code. Omitted when there is no value."},"country":{"type":["string","null"],"description":"Country. Omitted when there is no value."}},"additionalProperties":false,"description":"A destination address. Nested inside Order. Omitted when there is no value."}}}}
```

## The Note object

```json
{"openapi":"3.1.0","info":{"title":"Customer Webhooks","version":"v1"},"components":{"schemas":{"Note":{"required":["added_at","note","note_id"],"type":"object","properties":{"note_id":{"type":"integer","description":"Note identifier.","format":"int64"},"note":{"minLength":1,"type":"string","description":"Note text."},"added_at":{"type":"string","description":"When the note was added.","format":"date-time"},"added_by":{"type":["string","null"],"description":"Who added the note — use added_by_id. Not currently sent."},"added_by_id":{"type":["integer","null"],"description":"Author identifier. Omitted when there is no value.","format":"int64"}},"additionalProperties":false,"description":"A note attached to a line item. Nested inside Order."}}}}
```

## The Fee object

```json
{"openapi":"3.1.0","info":{"title":"Customer Webhooks","version":"v1"},"components":{"schemas":{"Fee":{"required":["name","value"],"type":"object","properties":{"name":{"minLength":1,"type":"string","description":"Fee name."},"value":{"type":"number","description":"Fee amount.","format":"double"}},"additionalProperties":false,"description":"An additional charge. Nested inside Order. The parent fees field is not currently sent."}}}}
```

## The FieldValue object

```json
{"openapi":"3.1.0","info":{"title":"Customer Webhooks","version":"v1"},"components":{"schemas":{"FieldValue":{"type":"object","properties":{"field_uid":{"type":["string","null"],"description":"Field unique identifier. Omitted when there is no value."},"name":{"type":["string","null"],"description":"Field name. Omitted when there is no value."},"value":{"type":["string","null"],"description":"Field value. Omitted when there is no value."}},"additionalProperties":false,"description":"A custom field value. Nested inside Order. The parent field_values field is not currently sent."}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.partssource.com/webhooks-customer/preview/event-reference.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.