Skip to content

Create an inbound RTB

POST
/api/v1/inbound-rtb
curl --request POST \
--url https://external-api.moja-ai.com/api/v1/inbound-rtb \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <X-API-Key>' \
--data '{ "inbound_rtb_id": "example", "campaign_id": "example", "publisher_id": "example", "payout_mode": "dynamic", "payout_percentage": 80, "duration_add_seconds": 0, "payout": 1, "payout_condition": "call_length_connected", "payout_condition_duration": 1, "allocation_time_seconds": 60, "rate_limit": 100, "rate_period": "min", "is_active": true, "receive_mode": "dynamic", "receive_number_id": "example", "external_id": "example" }'
X-API-Key
Any of:
string
Media typeapplication/json
InboundRtbCreate
object
inbound_rtb_id
required
Inbound Rtb Id
string
>= 1 characters <= 255 characters
campaign_id
required
Campaign Id
string
>= 1 characters <= 255 characters
publisher_id
required
Publisher Id
string
>= 1 characters <= 255 characters
payout_mode
Payout Mode
string
default: dynamic
Allowed values: dynamic static
payout_percentage
Any of:
number
duration_add_seconds
Any of:
integer
payout
Any of:
number
payout_condition
Any of:
string
Allowed values: call_length_connected call_length_incoming call_successfully_connected call_converted
payout_condition_duration
Any of:
integer
>= 1
allocation_time_seconds
Allocation Time Seconds
integer
default: 60 >= 1 <= 60
rate_limit
Rate Limit
integer
default: 100 >= 1
rate_period
Rate Period
string
default: min
Allowed values: min hour day
is_active
Is Active
boolean
default: true
receive_mode
Receive Mode
string
default: dynamic
Allowed values: dynamic static_standard static_multi_bid
receive_number_id
Any of:
string
<= 255 characters
external_id
Any of:
string
>= 1 characters <= 64 characters

Successful Response

Media typeapplication/json
InboundRtbResponse
object
id
required
Id
integer
inbound_rtb_id
required
Inbound Rtb Id
string
campaign_id
required
Campaign Id
string
campaign_name
Any of:
string
publisher_id
required
Publisher Id
string
publisher_name
Any of:
string
payout_mode
required
Payout Mode
string
payout_percentage
Any of:
number
duration_add_seconds
Any of:
integer
payout
Any of:
number
payout_condition
Any of:
string
payout_condition_duration
Any of:
integer
allocation_time_seconds
required
Allocation Time Seconds
integer
rate_limit
required
Rate Limit
integer
rate_period
required
Rate Period
string
is_active
required
Is Active
boolean
receive_mode
Receive Mode
string
default: dynamic
receive_number_id
Any of:
string
external_id
Any of:
string
created_at
Any of:
string format: date-time
updated_at
Any of:
string format: date-time
Example
{
"receive_mode": "dynamic"
}

Bad Request

Media typeapplication/json
ErrorResponse
object
detail
required
ErrorBody
object
code
required
Code
string
message
required
Message
string
Examplegenerated
{
"detail": {
"code": "example",
"message": "example"
}
}

Unauthorized

Media typeapplication/json
ErrorResponse
object
detail
required
ErrorBody
object
code
required
Code
string
message
required
Message
string
Examplegenerated
{
"detail": {
"code": "example",
"message": "example"
}
}

Not Found

Media typeapplication/json
ErrorResponse
object
detail
required
ErrorBody
object
code
required
Code
string
message
required
Message
string
Examplegenerated
{
"detail": {
"code": "example",
"message": "example"
}
}

Conflict

Media typeapplication/json
ErrorResponse
object
detail
required
ErrorBody
object
code
required
Code
string
message
required
Message
string
Examplegenerated
{
"detail": {
"code": "example",
"message": "example"
}
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Examplegenerated
{
"detail": [
{
"loc": [
"example"
],
"msg": "example",
"type": "example",
"input": "example",
"ctx": {}
}
]
}

Too Many Requests

Media typeapplication/json
ErrorResponse
object
detail
required
ErrorBody
object
code
required
Code
string
message
required
Message
string
Examplegenerated
{
"detail": {
"code": "example",
"message": "example"
}
}