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:

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.