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@2.0.1
iOS (Swift Package Manager)
// Xcode → File → Add Package Dependencies// URL: https://github.com/getpostback/postback-ios-sdk// Version: from "2.0.1"
Android (Gradle)
implementation("sh.postback:sdk:2.0.1")
Flutter
flutter pub add postback_flutter:^2.0.1
Configure the SDK
Call configure() as early as possible, ideally in your root component or App Delegate.
This minimal example uses React Native / Expo. If you chose iOS, Android, or Flutter, use the matching platform SDK guide below for its configuration and connectivity-test code.
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.