Moja AI
Integration Lab
Publisher integration guide · POC

Connect to Moja RTB with confidence.

Paste your inbound RTB URL to generate a prefilled setup guide and validate a payload locally—without sending a live ping.

This is a functional proof of concept.It generates useful integration instructions, but does not allocate routes or send traffic to Moja.

Suffix parameters are accepted, but the guide uses only the endpoint before the first “?”.

01

Your endpoint

Example endpoint

The endpoint below is a non-live example. Paste your assigned Moja URL above to replace it with your endpoint.

GET endpoint
https://rtb.moja.cloud/inbound_rtb/your-publisher-endpoint-id
Keep this URL private.The final path segment identifies your inbound RTB configuration. Share it only with the publisher implementing the integration.
02

Request flow

  1. 1
    Collect caller data

    Prepare the caller ID and any optional routing attributes available before the call.

  2. 2
    Send a GET request

    Add values as URL query parameters. Replace every {{PLACEHOLDER}} with a real value.

  3. 3
    Read the response

    Use the returned eligibility and allocation details to decide the next routing step.

  4. 4
    Route the matching call

    Follow the production contract supplied with your Moja account; do not reuse an expired allocation.

03

Payload reference

GET · query string

This POC requires CALLER_ID in its validator. Your production account may support additional fields or aliases such as CID; confirm the final contract before launch.

ParameterUseDescriptionExample
CALLER_IDRequired hereCaller phone number. E.164 (+12125550184) is preferred; CID may be supported by account configuration.+12125550184
FIRST_NAMEOptionalCaller first name.Jane
LAST_NAMEOptionalCaller last name.Doe
ZIP_CODEOptional5-digit US postal code or ZIP+4.10001
STATEOptional2-letter US state code.NY
Placeholders are templates—not literal values. Your publisher replaces values like {{CALLER_ID}} with actual caller data on every request.
Copy-ready request template
https://rtb.moja.cloud/inbound_rtb/your-publisher-endpoint-id?CALLER_ID={{CALLER_ID}}&FIRST_NAME={{FIRST_NAME}}&LAST_NAME={{LAST_NAME}}&ZIP_CODE={{ZIP_CODE}}&STATE={{STATE}}
04

Response examples

Illustrative response shapes for integration planning. Your account’s production contract is authoritative.

Eligible route
{
  "success": true,
  "request_id": "req_example_123",
  "eligible_routes": [
    { "route_id": "route_example", "bid": 24.50 }
  ],
  "allocation_time_seconds": 45
}
No eligible route
{
  "success": true,
  "request_id": "req_example_124",
  "eligible_routes": []
}
Validation error
{
  "success": false,
  "error": "Missing or invalid CALLER_ID"
}
05

Payload lab

Local only
No live RTB request is sent.Values remain in this browser session only. Validation and URL construction happen entirely on this page.

Paste your assigned endpoint to enable validation.

Locally constructed request preview
https://rtb.moja.cloud/inbound_rtb/your-publisher-endpoint-id?CALLER_ID={{CALLER_ID}}&FIRST_NAME={{FIRST_NAME}}&LAST_NAME={{LAST_NAME}}&ZIP_CODE={{ZIP_CODE}}&STATE={{STATE}}
06

Share this guide

Generate the guide first, then share the hash link whenever possible. Both links contain the endpoint identifier.