beehiiv Developer Documentation

curl -X POST https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/paid_recommendations/applications/rec_agr_00000000-0000-0000-0000-000000000000/reject \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "rejected_reason": "Our audiences don'\''t overlap enough."
}'

{
  "data": {
    "accepted_subscribers": 0,
    "auto_accepted": false,
    "created_at": 1767225600,
    "id": "rec_agr_00000000-0000-0000-0000-000000000000",
    "offer": {
      "id": "rec_offer_00000000-0000-0000-0000-000000000000",
      "name": "Spring growth offer"
    },
    "pending_spend_cents": 0,
    "pending_subscribers": 0,
    "recommending_publication": {
      "id": "pub_00000000-0000-0000-0000-000000000001",
      "name": "The Morning Brief",
      "url": "https://morningbrief.beehiiv.com/"
    },
    "status": "rejected",
    "total_spend_cents": 0,
    "total_subscribers": 0,
    "updated_at": 1767312000,
    "rejected_reason": "Our audiences don't overlap enough."
  }
}

Currently in beta

This feature is currently in beta and the API is subject to change.

Reject a pending application. The applicant is notified and sees the rejected reason.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

publicationIdstringRequiredformat: "^(pub_[0-9a-fA-F\-]+)$"

The prefixed ID of the publication object

applicationIdstringRequiredformat: "^(rec_agr_[0-9a-fA-F\-]+)$"

The prefixed ID of the application object

Request

This endpoint expects an object.

rejected_reasonstringOptional

Why you rejected the application. The applicant sees this reason.

Response

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error