Applications

Approve an application

The partner becomes active, the reviewer and time are recorded, application.approved and affiliate.confirmed fire, and the applicant gets the approval email with your overrides and sending domain. Refused when the application was already decided, or when your plan's revenue meter blocks new approvals.

Scope: partners:write (or write)

post/v1/applications/{id}/approve

Request

Base URL: https://api.affiliaterail.com
URL: https://api.affiliaterail.com/v1/applications/{id}/approve
Auth: HTTP bearer

Path parameters

idstring required

Prefixed id (app_…)

Example:app_7uSyy9FqVLCFWrdPeZaK

Response

The approved application

idstring required

Prefixed id (app_…)

object'application' required

program_idstring required

Prefixed id (prg_…)

group_idstring nullable required

Prefixed id (grp_…)

partner_idstring nullable required

Prefixed id (part_…)

emailstring required

answersunknown

sourcestring nullable required

status'pending' | 'approved' | 'rejected' | 'withdrawn' required

reviewed_by_user_idstring nullable required

reviewed_atstring date-time nullable required

ISO-8601, UTC

rejection_reasonstring nullable required

created_atstring date-time required

ISO-8601, UTC

updated_atstring date-time required

ISO-8601, UTC

Example response

{
  "id": "app_7uSyy9FqVLCFWrdPeZaK",
  "program_id": "prg_7uSyy9FqVLCFWrdPeZaK",
  "group_id": "grp_7uSyy9FqVLCFWrdPeZaK",
  "partner_id": "part_7uSyy9FqVLCFWrdPeZaK",
  "reviewed_at": "2026-08-21T10:15:30.000Z",
  "created_at": "2026-08-21T10:15:30.000Z",
  "updated_at": "2026-08-21T10:15:30.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.