API Reference

Adds a new offer to the specified partner.

post
https://platform.routy.app/api/v1/partners//offers

On success returns 201 Created with a Location header pointing at the new offer.
Admin-only endpoint (requires the SystemAdmin policy) gated by the partners feature.

🔐 Required permission: networks.read

🚩 Requires feature: partners

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int32
required

The unique identifier of the partner to which the offer will be added.

Body Params

The details of the offer to be added.

Request to create a new offer under a network (and optionally a specific partner).

int32

Required id of the network the offer belongs to.

int32 | null

Optional partner id to scope the offer to a single partner.

string | null
enum

Offer visibility: Public or Partners.

Allowed:
string | null

Required offer name.

string | null

Optional free-text description.

int32

Required brand link id representing the network account link.

countryCodes
array of strings | null

ISO country codes the offer targets; empty means all countries.

countryCodes
string | null

Optional region code the offer targets.

string | null

Currency code for the monetary amounts below (e.g. "USD").

double | null

Optional baseline amount used for revenue-share calculations.

double | null

Optional revenue-share percentage (0-100).

double | null

Optional cost-per-click payout amount.

double | null

Optional cost-per-acquisition payout amount.

double | null

Optional cost-per-lead payout amount.

boolean | null

If true, conversions on this offer are auto-approved.

date-time

UTC date/time from which the offer becomes active.

date-time | null

Optional UTC date/time on which the offer ends.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses

Updated 22 days ago

Did this page help you?
Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json
text/json

Updated 22 days ago

Did this page help you?