Orders
Orders endpoints may be used to report customer transactions as they happen. These are used within Poplar for attribution reporting and to enable existing customers to be easily suppressed within your campaigns.
You can monitor this API integration from the Transactions Page of the dashboard. We provide basic diagnostic information and the ability to purge any transactional data stored within your account.
Submit Order
POST
https://api.heypoplar.com/v1/order
https://api.heypoplar.com/v1/order
Use this endpoint to report a new transaction or order
In addition to the required fields, at least one of the following must be provided: shipping_address
, billing_address
, customer_email_sha256
, or customer_email
Headers
Request Body
Shipping & Billing Address
Shipping and billing address objects should contain the following fields:
Order Items
You may provide order item details with an order. This is optional, however this data is used to add additional dimensions to our reporting.
Metadata
Optional metadata may be provided with Orders and Order Items. This data is used to enhance reporting. For example, you may wish to include a flag which indicates a customer's first time order or segment.
The metadata object should consist of
key : value
pairs.You are permitted up to 10 different keys.
Each key should be a string, up to 40 characters in length.
Values should string, number or boolean types, limited to a maximum length of 200 characters.
We've pre-defined the following keys for advanced reporting.
If you'd like to have this data in your reports, you must name them exactly as they appear above. For example, if you name the key nb
instead of new_buyer
your reports will NOT show the information.
Customers (Orders API)
When you submit transactions to the Orders API we will also automatically create an audience called "Customers (Orders API)" that will include customers of the orders. The audience will contain two records for each order submitted one with the shipping address, and one with the billing address.
This list is useful when you are mailing prospecting campaigns and want to suppress existing customers that have been submitted to the Orders API. (note unless you have submitted all historical orders it will not be a complete customer list) You cannot mail this audience as a one time send.
Delete Order
DELETE
https://api.heypoplar.com/v1/order/:order_id
https://api.heypoplar.com/v1/order/:order_id
Deletes the specified order by ID.
Path Parameters
Headers
Edit Order
POST
https://api.heypoplar.com/v1/order/:order_id
https://api.heypoplar.com/v1/order/:order_id
Allows updates to be made to the specified order. This method accepts the same parameters as order submission, with the exception of order_id
- this cannot be changed.
Path Parameters
Headers
Last updated