> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.offerzy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Placements

> A placement connects one site or app to Offerzy: its offerwall link, currency, postback URL and reporting.

Create one placement for every site or app where you show offers. Each placement has its own offerwall link, currency settings, postback URL and reports, so you can see how each product performs.

<Tip>
  Have a website and apps? Create a separate placement for each platform, for example "Coinly Web", "Coinly Android" and "Coinly iOS".
</Tip>

## Create a placement

In the dashboard, open **Placements** and click **Create placement**.

<ParamField body="Placement name" type="string" required>
  Your name for it, usually the site or app name. Users don't see it.
</ParamField>

<ParamField body="Platform" type="Web | Android | iOS" required>
  Where the offerwall runs.
</ParamField>

<ParamField body="Type" type="Offerwall | API" required>
  **Offerwall** is the hosted page you embed or open, and it suits almost every publisher. **API** is for building your own offer interface; see [Offers API](/api). The type can't be changed later.
</ParamField>

<ParamField body="Site or app link" type="URL" required>
  Your website or app store page. We use it to review the placement.
</ParamField>

<ParamField body="Postback URL" type="URL">
  The endpoint that credits your users. You can add it later; see [Postbacks](/postbacks/overview).
</ParamField>

## Review and status

New placements are reviewed before they can show offers, usually within a day. You can set the currency and test postbacks while you wait.

| Status | Meaning |
| - | - |
| **In review** | Waiting for approval. |
| **Live** | Approved and showing offers. |
| **Paused** | Not showing offers. |
| **Rejected** | Not approved. Contact us if you'd like to know why. |

## Where to find your details

Open a placement from **Placements**:

* **Offerwall link**: on the placement card and in **Settings**. It looks like `https://wall.offerzy.io/{placement_id}?user_id={USER_ID}`.
* **API key**: on the card of an API placement.
* **Secret key**: under **Settings** in the main menu. One key signs the postbacks of all your placements; see [Verify postbacks](/postbacks/security).

The placement's tabs hold everything else: **Settings** (currency and postback URL), **Events** (reward boosts) and **Test postback**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.