> ## Documentation Index
> Fetch the complete documentation index at: https://onlytraffic.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Accept CPL Campaign

> Accepts a waiting campaign placed on your CPL offer. Same rules as the **Accept** modal on the CPL Campaigns page:

- **Trial campaigns** need `trial_days`, chosen from the campaign's own list (default list: 1, 3, 7, 14, 30, 90, 180, 360).
- **OT tracking-link campaigns without a predefined link** need `fallback_url`: the OnlyFans page a fan lands on, `https://onlyfans.com/…`, max 255 characters.

Other campaigns ignore both fields. Returns the campaign as one `/api/marketer/cpl/campaigns` row with `status` = `accepted`.

**Errors** (`status: "error"`, HTTP 200):

- `404` `Order not found`.
- `422` `Choose a trial period: 1 | 3 | 7 | 14 | 30 | 90 | 180 | 360` (the list is the campaign's own), `Fallback URL is required and must start with https://onlyfans.com/`, or the platform's message when the campaign can no longer be accepted.
- `403` Access denied: missing / unknown key, or the account is not an active partner.
- `429` Rate limit exceeded (30 writes per minute per key, see the `Retry-After` header).
- `503` Service is temporarily unavailable: the platform did not answer in time. The action may still have been applied, check the matching read endpoint before repeating it.

Same as **Accept** on the CPL Campaigns page. `order_id` is the `cplo_…` public id from [`/api/marketer/cpl/campaigns`](/docs/partners/api/cpl-campaigns); the campaign must be in `waiting` status.

## Conditional fields

Two fields are required only for some campaigns, exactly like the Accept modal:

| Field          | When it is required                                                                                                                                       |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `trial_days`   | Trial campaigns. Must be one of the campaign's allowed values; the default list is 1, 3, 7, 14, 30, 90, 180, 360                                          |
| `fallback_url` | Campaigns on an OT tracking link without a predefined link. The OnlyFans page a fan lands on: must start with `https://onlyfans.com/`, max 255 characters |

Other campaigns ignore both. `comment` is optional and shown to the client.

## Errors

| Message                                                              | Meaning                                                         |
| -------------------------------------------------------------------- | --------------------------------------------------------------- |
| `Order not found`                                                    | Unknown id, not your campaign, or a numeric internal id (`404`) |
| `Choose a trial period: 1 \| 3 \| 7 \| …`                            | `trial_days` missing or not in the campaign's list (`422`)      |
| `Fallback URL is required and must start with https://onlyfans.com/` | `fallback_url` missing or invalid (`422`)                       |
| Platform text                                                        | The campaign can no longer be accepted (`4xx`)                  |


## OpenAPI

````yaml api/openapi-partners.json POST /api/marketer/cpl/campaigns/accept
openapi: 3.0.2
info:
  title: OnlyTraffic Marketer API
  version: 2.1.0
  description: >-
    Partner (marketer) API for OnlyTraffic.


    **Authentication:** pass your API key in the `Authorization` header
    (`Authorization: your-api-key` or `Authorization: Bearer your-api-key`).
    Create keys in the partner cabinet: Tools -> API
    (https://partners.onlytraffic.com/tools/api). Up to 5 named keys per
    account, each **Full** or **Read-only**, with an optional expiry. Keys start
    with `ot_partners_` and are shown once, at creation. Read-only keys cannot
    call the `POST` endpoints (`error_code` 403, message `This API key is
    read-only`). An older legacy key keeps working with full access until you
    delete it on the same page.


    **Pagination:** all list endpoints accept `offset` (default 0) and `limit`
    (default 50, max 1000) as query parameters or JSON body fields.


    **Dates:** every timestamp field has two variants — an ISO 8601 string
    (`*_at`) and a Unix timestamp integer (`*_at_ts` / `*_ts`).


    **Writes:** a Full-access key reads and writes. Write endpoints are `POST`
    with a JSON body, accept public ids only (`revc_…`, `cplo_…`) and answer
    with the updated object in `data`. Rate limit: 120 requests per minute for
    reads, 30 per minute for writes, per account (shared by all its keys).
servers:
  - url: https://partners.onlytraffic.com
security: []
tags:
  - name: RevShare
    description: RevShare campaigns and financial data
  - name: CPL
    description: Cost-Per-Lead orders placed against your offers
  - name: CPC
    description: Cost-Per-Click orders and the category catalog
  - name: Subscribers
    description: Fans acquired through your campaigns
  - name: Stats
    description: Dashboard-style statistics widgets (fans, income, conversion)
  - name: Write
    description: >-
      Write API: start / stop / update campaigns and accept / reject / stop CPL
      campaigns (same key, same rules as the cabinet)
paths:
  /api/marketer/cpl/campaigns/accept:
    post:
      tags:
        - Write
      summary: Accept a CPL campaign
      description: >-
        Accepts a waiting campaign placed on your CPL offer. Same rules as the
        **Accept** modal on the CPL Campaigns page:


        - **Trial campaigns** need `trial_days`, chosen from the campaign's own
        list (default list: 1, 3, 7, 14, 30, 90, 180, 360).

        - **OT tracking-link campaigns without a predefined link** need
        `fallback_url`: the OnlyFans page a fan lands on,
        `https://onlyfans.com/…`, max 255 characters.


        Other campaigns ignore both fields. Returns the campaign as one
        `/api/marketer/cpl/campaigns` row with `status` = `accepted`.


        **Errors** (`status: "error"`, HTTP 200):


        - `404` `Order not found`.

        - `422` `Choose a trial period: 1 | 3 | 7 | 14 | 30 | 90 | 180 | 360`
        (the list is the campaign's own), `Fallback URL is required and must
        start with https://onlyfans.com/`, or the platform's message when the
        campaign can no longer be accepted.

        - `403` Access denied: missing / unknown key, or the account is not an
        active partner.

        - `429` Rate limit exceeded (30 writes per minute per key, see the
        `Retry-After` header).

        - `503` Service is temporarily unavailable: the platform did not answer
        in time. The action may still have been applied, check the matching read
        endpoint before repeating it.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - order_id
              properties:
                order_id:
                  type: string
                  description: >-
                    CPL campaign public id (`cplo_…`). Numeric internal ids are
                    rejected with 404.
                trial_days:
                  type: integer
                  description: >-
                    Trial length in days. Required for trial campaigns only;
                    must be one of the campaign's allowed values.
                fallback_url:
                  type: string
                  maxLength: 255
                  description: >-
                    Required for OT tracking-link campaigns without a predefined
                    link. Must start with `https://onlyfans.com/`.
                comment:
                  type: string
                  description: Message to the client, shown on the campaign.
            example:
              order_id: cplo_abc123
              trial_days: 7
              comment: Starting today
      responses:
        '200':
          description: Success (check `status`; errors are also HTTP 200)
          content:
            application/json:
              schema:
                oneOf:
                  - title: Success
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - success
                      message:
                        type: string
                        description: Confirmation text from the platform, when present.
                      data:
                        $ref: '#/components/schemas/CplCampaign'
                  - $ref: '#/components/schemas/ErrorResponse'
              examples:
                success:
                  summary: Success
                  value:
                    status: success
                    data:
                      order_id: cplo_abc123
                      offer_id: 5
                      client_offer_id: null
                      is_client_offer: false
                      of_account_id: 456789
                      of_username: modelname
                      url: https://onlyfans.com/modelname/c1
                      source: Telegram
                      quantity_ordered: 100
                      quantity_delivered: 67
                      price_per_subscriber: 2.5
                      total_earned: 167.5
                      status: accepted
                      onlyfans_account:
                        name: Model Name
                        username: modelname
                        about: About text
                        tags:
                          - brunette
                        avatar:
                          original: https://cdn.example.com/avatar.jpg
                          thumbnail: https://cdn.example.com/avatar_thumb.jpg
                          thumbnail_640: https://cdn.example.com/avatar_640.jpg
                        demo_content: []
                        regular_price: 9.99
                        promotions: []
                        blocked_countries: []
                        subscribers_count: 3400
                        likes_count: 87000
                        posts_count: 560
                        photos_count: 420
                        videos_count: 140
                        performer_top: 5
                      auto_renewal:
                        enabled: true
                        quantity: 100
                        max_price: 3
                        next_price: 2.5
                        can_renew: false
                      created_at: '2024-01-15T08:00:00+00:00'
                      created_at_ts: 1705305600
                      changed_at: '2024-06-01T12:00:00+00:00'
                      changed_at_ts: 1717243200
                      completed_at: null
                      completed_at_ts: null
                error:
                  summary: Error
                  value:
                    status: error
                    error_code: 422
                    message: Please fill in all campaign fields
      security:
        - api_key: []
components:
  schemas:
    CplCampaign:
      type: object
      properties:
        order_id:
          type: string
          description: CPL campaign public id (prefix `cplo_`).
        offer_id:
          type: integer
          description: Partner offer id. `0` for client-offer campaigns.
        client_offer_id:
          type: integer
          nullable: true
          description: >-
            Client offer id for client-offer campaigns; `null` for partner-offer
            campaigns.
        is_client_offer:
          type: boolean
          description: '`true` when the campaign was placed against a client offer.'
        of_account_id:
          type: integer
        of_username:
          type: string
        url:
          type: string
          format: uri
          nullable: true
          description: >-
            Promotion URL (OnlyFans campaign/trial link). Available once the
            campaign has been accepted; `null` otherwise.
        source:
          type: string
          nullable: true
          description: >-
            Traffic source (from the running campaign, falling back to the
            offer). `null` until the campaign is accepted.
        quantity_ordered:
          type: integer
        quantity_delivered:
          type: integer
          description: >-
            Delivered actions counted against the campaign's target action
            (subscriptions, messages, purchases, or paid subscriptions).
        price_per_subscriber:
          type: number
        total_earned:
          type: number
          description: >-
            billable × price_per_subscriber, where billable = min(ordered,
            delivered), or all delivered actions when the campaign is open-ended
            (quantity = 0).
        status:
          type: string
          enum:
            - waiting
            - accepted
            - rejected
            - completed
            - cancelled
            - paused
        onlyfans_account:
          $ref: '#/components/schemas/OnlyfansAccount'
        auto_renewal:
          type: object
          properties:
            enabled:
              type: boolean
            quantity:
              type: integer
              description: Repeat quantity when the campaign completes.
            max_price:
              type: number
              description: Maximum payout per subscriber you may charge on a renewal.
            next_price:
              type: number
              description: >-
                Your payout per subscriber for the next cycle, resolved from the
                offer price steps for the repeat quantity.
            can_renew:
              type: boolean
              description: >-
                Whether the renewal will actually go through: client account
                active, offer available, price within the cap and enough balance
                for the next cycle.
        created_at:
          type: string
          format: date-time
        created_at_ts:
          type: integer
        changed_at:
          type: string
          format: date-time
        changed_at_ts:
          type: integer
        completed_at:
          type: string
          format: date-time
          nullable: true
        completed_at_ts:
          type: integer
          nullable: true
    ErrorResponse:
      title: Error
      type: object
      properties:
        status:
          type: string
          enum:
            - error
        message:
          type: string
          description: Human-readable error description.
        error_code:
          type: integer
          description: >-
            403: access denied (missing / unknown / expired / revoked key, or
            the account is not an active partner: `Error! Access denied`; a
            Read-only key calling a write endpoint: `This API key is
            read-only`). 404: not found. 422: bad request params (message says
            what is wrong). 429: rate limit exceeded (a `Retry-After` header is
            set) or another campaign start is still running. 500: server error.
            503: the platform did not answer a write in time, retry later.
    OnlyfansAccount:
      type: object
      description: Cached snapshot of the OnlyFans model profile.
      properties:
        name:
          type: string
        username:
          type: string
        about:
          type: string
        tags:
          type: array
          items:
            type: string
        avatar:
          type: object
          properties:
            original:
              type: string
              format: uri
            thumbnail:
              type: string
              format: uri
            thumbnail_640:
              type: string
              format: uri
        demo_content:
          type: array
          description: >-
            Model's demo photos/videos. Empty for finished campaigns and for
            completed/rejected CPL campaigns.
          items:
            type: object
            properties:
              type:
                type: string
                enum:
                  - photo
                  - video
              url:
                type: string
                format: uri
              thumbnail:
                type: string
                format: uri
        regular_price:
          type: number
        promotions:
          type: array
        blocked_countries:
          type: array
          items:
            type: string
        subscribers_count:
          type: integer
        likes_count:
          type: integer
        posts_count:
          type: integer
        photos_count:
          type: integer
        videos_count:
          type: integer
        performer_top:
          type: number
          description: Top percentage among all performers (e.g. 5 = top 5%).
  securitySchemes:
    api_key:
      type: apiKey
      name: Authorization
      in: header
      description: >-
        API key from the partner cabinet, Tools -> API
        (https://partners.onlytraffic.com/tools/api): up to 5 named keys per
        account, each Full or Read-only, `ot_partners_` prefix, shown once at
        creation. Raw value or `Bearer` form. Read-only keys cannot call the
        `POST` endpoints (403 `This API key is read-only`); expired or revoked
        keys get 403 `Error! Access denied`.

````