Documentation

Quickstart

Install the SDK, configure your API key, and send your first test event. Takes about 5 minutes.

Get your API key

Create an app in the Postback dashboard and copy your live API key. Keys start with pb_.

Install the SDK

Pick your platform and add the package:

React Native / Expo

npm install postback-react-native@1.0.0

iOS (Swift Package Manager)

// Xcode → File → Add Package Dependencies
// URL: https://github.com/getpostback/postback-ios-sdk
// Version: from "1.0.0"

Android (Gradle)

implementation("sh.postback:sdk:1.0.0")

Flutter

flutter pub add postback_flutter:^1.0.0

Configure the SDK

Call configure() as early as possible, ideally in your root component or App Delegate.

import { Postback } from 'postback-react-native';
await Postback.configure({
apiKey: 'YOUR_API_KEY',
});

This registers the install, collects privacy-conscious device signals for attribution, and starts matching.

Send a test event

Use sendTestEvent() to verify end-to-end connectivity:

const result = await Postback.sendTestEvent();
console.log(result.success, result.message);

View in dashboard

Open your app in the Postback dashboard. You should see the test event within seconds.

Next steps