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.