Skip to main content

Overview

Written by GoKart Support

You can now integrate with any 3rd-party (provided they have a public API to use) directly from GoKart’s Integrations tab, without relying on GoKart for setup (This includes offerwalls, and others partner types). Offers from your 3rd party will automatically populate in the Third-Party Offers tab.

POST /api/v1/integrations/offer-providers/custom/offers

This request receives a batch of offers for creation or update and starts a synchronization process in the background.


Typical Workflow

  1. Fetch Offers from 3rd-Party Provider
    The publisher calls the 3rd-party provider’s API to retrieve available offers (e.g. offerwall provider, partner network, etc.).

  2. Transform the Data
    The publisher maps the 3rd-party offer data into GoKart’s expected payload format.

  3. Send Offers to GoKart
    The publisher a POST request containing:

    • A unique concurrencyRequestId (UUID) for idempotency

    • An operation (“Synchronize” or “Insert”)

    • A list of mapped offers under offers

  4. GoKart Server Processes the Request

    • Offers are created or updated in the system

    • A background sync process is triggered

  5. The server responds with details of created, updated, unchanged, or failed offers.


Best Practices

To ensure optimal performance and stability, we ask that you use the POST API with discretion. Your integration strategy should avoid making large, frequent calls or executing concurrent requests, as this can overload our system and degrade performance.

​If you are using the API to refresh or retrieve data, we recommend implementing a more efficient strategy that reduces the frequency and size of your requests. Excessive or repeated heavy calls may result in throttling or temporary access limitations to protect platform stability.

For more examples and best practices, review our guide here.

Did this answer your question?