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@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.

Next steps