POST /proposal/accept
NOTE: The EPA API has sunset on September 30, 2026. Endpoints are no longer accessible. For alternatives, see EPA to PDP Migration.
Enables the seller or the buyer to accept the current proposal revision.
Here's what you need to know about accepting proposals:
- The Trade Desk activates proposals after both the buyer and seller accept the proposal.
- Before the buyer can accept the proposal, the seller must first accept it.
Request example
To accept a proposal, use the POST /proposal/accept endpoint and specify the proposal ID and the current revision number.
{
"ProposalId": 1234,
"RevisionNumber": 3
}
Request object properties
The following table lists the POST /proposal/accept request object properties.
| Property | Required? | Value Type | Description |
|---|---|---|---|
ProposalId |
Required | Integer | The unique ID of the proposal that you want to accept. |
RevisionNumber |
Required | Integer | The latest revision number of the proposal you want to accept. See also the Revisions section in Easy Proposal Activation API IMPORTANT: Be sure to enter the current revision number or the request will fail. |
Response example
A successful response to a POST /proposal/accept request returns a Proposal object with an updated revision number and the SellerAccepted value is set to true. The ProposalState value has not change since the buyer has not accepted the proposal.
{
"ProposalId": 1234,
"DisplayName": "Test Proposal",
"RevisionNumber": 4,
"Buyer": {
"BuyerId": "5168"
},
"Seller": {
"SellerId": "Test",
"SellerName": "Test Seller"
},
"Deals": [
{
"DealId": 5367297813,
"DisplayName": "Test Deal",
"ExternalDealId": "4263497813",
"PublisherIds": [
"1234"
],
"StartTime": null,
"EndTime": null,
"DealType": "Preferred",
"PreferredDealTerms": {
"RateType": "CPM",
"Rate": {
"Amount": 0.050000,
"CurrencyCode": "USD"
}
},
"CreativeRestrictions": {
"CreativeFormat": "Display"
},
"CreateTime": "2021-08-19T18:53:18.05",
"UpdateTime": "2021-08-19T18:53:18.05"
}
],
"Notes": [],
"SupplyVendorId": "1234567",
"CreatedBy": "Seller",
"LastUpdatedBy": "Seller",
"ProposalState": "Proposed",
"SellerAccepted": "true",
"BuyerAccepted": "false",
"CreatedTime": "2021-08-19T18:53:18.05",
"UpdatedTime": "2021-08-20T23:01:41.05",
"LastActivatedRevisionNumber": null
}
For details on the individual properties, see Proposal object and Deals object.
Error codes and messages
The following table provides a list of common errors and their respective HTTP error codes.
| HTTP Code | Status | Description |
|---|---|---|
| 403 | Forbidden | The proposal is not in the Proposed state. |
| 404 | Not Found | The proposal or revision does not exist. |
| 409 | Conflict | A newer revision already exists. |
| 410 | Gone | The proposal has been deleted by the buyer or seller. |