Create an affiliate

Affiliates

Description

Create a new affiliate business.

Authentication Required: User must be authenticated and have the 'affiliate' role.

The affiliate is created with a pending_validation status by default.

Request Body

required

`application/json`

organization_namestringrequired

Name of the affiliate organization (required)

Example: Tech Promotions Inc

website_urlstring (uri)

Affiliate website URL

Example: https://techpromotions.com

activity_typesarray [string]required

List of activity types (required)

Example: ["Content \u003e Cashback"]

activity_introductionstring

Introduction text describing the affiliate's activity

Example: We promote tech products through cashback and discount codes.

Responses

201 Affiliate created successfully

application/json

statusstring

Example: success

messagestring

Example: Affiliate created successfully

dataobject

401 Authentication required

application/json

Example:

{
  "status": "error",
  "message": "Not authenticated or insufficient permissions"
}

403 Insufficient permissions

application/json

Example:

{
  "status": "error",
  "message": "Feature affiliate required"
}

422 Validation error

application/json

Example:

{
  "status": "error",
  "message": "Failed to create affiliate",
  "errors": [
    {
      "path": "organization_name",
      "message": "Organization name can't be blank"
    }
  ]
}