Update a RevShare campaign

curl --request POST \
  --url https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "campaign_id": "revc_abc123",
  "name": "Telegram channel A",
  "tags": [
    "test-tag"
  ]
}
'

import requests

url = "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update"

payload = {
    "campaign_id": "revc_abc123",
    "name": "Telegram channel A",
    "tags": ["test-tag"]
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({campaign_id: 'revc_abc123', name: 'Telegram channel A', tags: ['test-tag']})
};

fetch('https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'campaign_id' => 'revc_abc123',
    'name' => 'Telegram channel A',
    'tags' => [
        'test-tag'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update"

	payload := strings.NewReader("{\n  \"campaign_id\": \"revc_abc123\",\n  \"name\": \"Telegram channel A\",\n  \"tags\": [\n    \"test-tag\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"campaign_id\": \"revc_abc123\",\n  \"name\": \"Telegram channel A\",\n  \"tags\": [\n    \"test-tag\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"campaign_id\": \"revc_abc123\",\n  \"name\": \"Telegram channel A\",\n  \"tags\": [\n    \"test-tag\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "campaign_id": "revc_abc123",
    "of_account_id": 456789,
    "of_username": "modelname",
    "name": "My RevShare Campaign",
    "url": "https://onlyfans.com/modelname/c1",
    "type": "link",
    "status": "active",
    "revshare_percent": 40,
    "visits": 1200,
    "subscribers": 85,
    "subscribers_today": 3,
    "income": 542.3,
    "income_today": 12.5,
    "revenue": 216.92,
    "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
    },
    "tags": [
      "test-tag"
    ],
    "created_at": "2024-01-01T00:00:00+00:00",
    "created_at_ts": 1704067200,
    "finished_at": null,
    "finished_at_ts": null,
    "changed_at": "2024-06-01T12:00:00+00:00",
    "changed_at_ts": 1717243200
  }
}

Write

Update RevShare Campaign

Renames a campaign, changes its note or its tags. Same as Edit on the Campaigns page. Fields left out keep their current value.

tags replaces the whole tag list with tag names from your tag list (Campaigns -> Tags); unknown names are rejected and tags are not created here. Send an empty array to clear the tags.

Returns the updated campaign row.

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

404 Campaign not found.
422 Unknown tag: <name> or Incorrect tags: array of tag names.
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.

POST

api

marketer

revshare

campaigns

update

Update a RevShare campaign

curl --request POST \
  --url https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "campaign_id": "revc_abc123",
  "name": "Telegram channel A",
  "tags": [
    "test-tag"
  ]
}
'

import requests

url = "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update"

payload = {
    "campaign_id": "revc_abc123",
    "name": "Telegram channel A",
    "tags": ["test-tag"]
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({campaign_id: 'revc_abc123', name: 'Telegram channel A', tags: ['test-tag']})
};

fetch('https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'campaign_id' => 'revc_abc123',
    'name' => 'Telegram channel A',
    'tags' => [
        'test-tag'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update"

	payload := strings.NewReader("{\n  \"campaign_id\": \"revc_abc123\",\n  \"name\": \"Telegram channel A\",\n  \"tags\": [\n    \"test-tag\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"campaign_id\": \"revc_abc123\",\n  \"name\": \"Telegram channel A\",\n  \"tags\": [\n    \"test-tag\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://partners.onlytraffic.com/api/marketer/revshare/campaigns/update")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"campaign_id\": \"revc_abc123\",\n  \"name\": \"Telegram channel A\",\n  \"tags\": [\n    \"test-tag\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "campaign_id": "revc_abc123",
    "of_account_id": 456789,
    "of_username": "modelname",
    "name": "My RevShare Campaign",
    "url": "https://onlyfans.com/modelname/c1",
    "type": "link",
    "status": "active",
    "revshare_percent": 40,
    "visits": 1200,
    "subscribers": 85,
    "subscribers_today": 3,
    "income": 542.3,
    "income_today": 12.5,
    "revenue": 216.92,
    "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
    },
    "tags": [
      "test-tag"
    ],
    "created_at": "2024-01-01T00:00:00+00:00",
    "created_at_ts": 1704067200,
    "finished_at": null,
    "finished_at_ts": null,
    "changed_at": "2024-06-01T12:00:00+00:00",
    "changed_at_ts": 1717243200
  }
}

Same as Edit on the Campaigns page. Fields you leave out keep their current value.

Errors

Message	Meaning
`Campaign not found`	Unknown id, not your campaign, or a numeric internal id (`404`)
`Unknown tag: <name>`	The name is not in your tag list (`422`)
`Incorrect tags: array of tag names`	`tags` is not an array (`422`)

Authorizations

Authorization

string

header

required

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.

Body

application/json

campaign_id

string

required

Campaign public id (revc_…).

name

string

Campaign name.

note

string

Private note.

Response

200 - application/json

Success (check status; errors are also HTTP 200)

Success
Error

status

enum<string>

Available options:

success

data

object

Show child attributes

Overview

Platforms

Work Formats

Payments & Safety

API

Update RevShare Campaign

Tags

Errors

Authorizations

Body

Response

​Tags

​Errors

Authorizations

Body

Response

Tags

Errors