Integration Overview

Welcome to the Bilt Partner Integration documentation. This guide outlines the core components required to integrate your platform with Bilt’s connected ecosystem.

Integration Capabilities

There are a few variations of data integrations with Bilt, consisting of (but not limited to):

Capability	Description	Components	Required
Bilt to Partner Linking	Account linking initiated from the Bilt app; Bilt calls APIs you host — see Bilt to Partner Account Linking	Bearer token	Yes
Account Unlinking	Bidirectional — either side can disconnect a link, see Bilt to Partner Account Linking	POST API	Yes
Order Reporting	You send Bilt each purchase and refund made by a linked member so Bilt can reward it — see Order Reporting	API key, POST webhook	Yes, for rewards partners
Order Status	You check whether Bilt accepted an order you sent, and why not if it did not — see Order Reporting §7.3–7.4	Bearer token, GET API	Recommended

Typical integration sequence

Link — the member connects their Bilt account to yours (account linking above).
Report — each time that member makes a purchase or gets a refund, you POST the event to Bilt’s order webhook. Bilt answers 200 right away and checks the event within seconds.
Check — you read the order’s status, or list the orders Bilt rejected, and resend once the cause is fixed (most often the member was not linked yet).

​Integration Overview

​Integration Capabilities

​Typical integration sequence

Integration Overview

Integration Capabilities

Typical integration sequence