# Mobile App Inbox

Mobile App Inbox is a webhook that delivers push notification data to your own endpoint after a campaign is sent. Use it to store notification history in your backend or build an in-app inbox screen.

Positive User checks for sent push notifications every 15 minutes and posts them in bulk to the URL you configure.

# Setup

1. In Positive User, go to Settings → App Settings → Additional → Mobile App Inbox
2. Enter the endpoint URL that will receive the notification payloads
3. Optionally, provide a Bearer token - it will be sent in the Authorization header with every request

Once configured, enable the inbox for each push campaign individually during campaign creation. The toggle is off by default.

# Payload format

Each request is a POST with a JSON array. One object per recipient:

[
    {
        "recipient": {
            "id": "your-internal-user-id",
            "fcm_key": "<device_fcm_token>",
            "email": "contact@example.com"
        },
        "message": {
            "campaign_id": 70,
            "id": 99,
            "title": "Hello, don't miss out!",
            "content": "Only 3 hours left",
            "link": "app://offers/listing",
            "image": "https://example.com/image.png"
        }
    }
]

recipient.id and recipient.email may be null for anonymous contacts.

# Requirements

• Endpoint URL configured in Positive User App Settings
• Toggle enabled on each push campaign where inbox delivery is needed