Search specific term/phrase surrounded by double quotes. e.g. “deep linking”
Exclude records that contain a specific term prefixed with a minus. e.g. Android -Firebase

Scheduled Log Exports: GCP Storage Expansion

Branch is adding GCP as a cloud service provider you can select when deciding where to send your Scheduled Log Exports API data. 🌩️


Branch's Scheduled Log Exports API lets you schedule daily or hourly exports of your log-level Branch data. You can choose to get an email with this data, store the data in Branch's AWS S3 buckets, or store the data with your own cloud provider.

Previously, if you chose to store your data with your own cloud provider, you could only do so with AWS.

However, Branch is happy to announce that it is now possible to store your data with another one of the industry's biggest players: GCP!

API Access

Access to the Scheduled Log Exports API is restricted to Enterprise accounts. Please contact your Branch Account Manager to confirm if your account is eligible for enablement.

Cloud Configuration

Before exporting your Branch data to GCP, you will first need to properly configure your cloud account so that the data has a place to land.

For steps on how to configure your GCP account to work with the Scheduled Log Exports API, view Branch's cloud setup guide.

API Usage

Pointing the Scheduled Log Exports API to your GCP account happens during the subscription creation call.

A subscription is a single report (which includes information such as data source, fields, and filters) that is set up to be exported over and over at a regular cadence.

To create a subscription, send a POST request to the /scheduled-exports/logs/subscribe endpoint.

Make sure to set destination.subscription_type to cloud and to gcs.

You will also need to set:

  1. destination.resource_access_id: the full service account name, which looks like an email address
    For example: [email protected]
  2. destination.bucket: the name of the GCP bucket
    For /buckets/my-branch-bucket/objects/branch/important_reports/ this would be my-branch-bucket
  3. destination.prefix: the prefix path for the bucket
    For /buckets/my-branch-bucket/objects/branch/important_reports/ this would be branch/important_reports

Example Subscription Creation Request

This example sets the data export's destination to GCP:

curl -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' \
-H 'access-token: api_app_99999999999999999999999999999999' -d '{
  "report": {
    "cadence": "hourly",
    "response_format": "csv",
    "response_format_compression": "gz",
    "report_type": "eo_install",
    "report_fields": [
    "filter": [
  "destination": {
    "subscription_type": "cloud",
    "cloud": "gcs",
    "resource_access_id": "[email protected]",
    "bucket": "my-branch-bucket",
    "prefix": "branch/important_reports"
}' ''

Learn More

For all the details about the Scheduled Log Exports API, visit our reference guide.