Branch allows you to create multiple marketing links at once directly on the dashboard or via API.

Step by Step instructions to create multiple links at once on the dashboard

  1. Create a CSV file with redirection URLs and analytics information you’d like to include in the Branch link. 

  2. Include “$marketing_title” in the data column if you intend for the link to be displayed on the dashboard on  Quick links tab. 

  3. Add analytics data you’d like to track for the links under the campaign, channel and tags columns. 

  4. Any custom data you’d like included in the link can be inserted in a JSON format under the data column.

  5. You can set a custom alias for each link by including a value in the alias column. For example, if you’d like to create a link that looks like branch.app.link/facebook , include “facebook” under the alias column. 

    • Note: Alias is unique to a link and cannot be reused or edited after the link is created. 

  6. Once you have the final CSV ready to be uploaded, go to Quick links on your Branch dashboard. 

  7. Hit the “Bulk Create Links” and upload your CSV file. 

Pro Tips: 

  • Branch does not support deleting links once created. You can archive the ones you don’t intend to use. 
  • When uploading a large CSV file with multiple links we recommend testing with a smaller file with 4-5 lines to validate everything looks as expected before uploading the large file. 
  • If your CSV file has more 50,000 lines, we recommend breaking it into multiple smaller files and uploading each file individually. 

Step by Step instructions to create multiple links at once via API

 You can make a POST request to Branch’s v1/url/bulk endpoint to create multiple links at once. Here’s an example curl request: 

curl -XPOST https://api.branch.io/v1/url/bulk/key_live_kaFuWw8WvY7yn1d9yYiP8gokwqjV0Swt \
  -d '[
    {
      "channel": "facebook",
      "feature": "onboarding",
      "campaign": "new product",
      "stage": "new user",
      "tags": ["one", "two", "three"],
      "data": {
        "$canonical_identifier": "content/123",
        "$og_title": "Title from Deep Link",
        "$og_description": "Description from Deep Link",
        "$og_image_url": "http://www.lorempixel.com/400/400/",
        "$desktop_url": "http://www.example.com",
        "custom_boolean": true,
        "custom_integer": 1243,
        "custom_string": "everything",
        "custom_array": [1,2,3,4,5,6],
        "custom_object": { "random": "dictionary" }
      }
    },
    {
      "channel": "facebook",
      "feature": "onboarding",
      "campaign": "new product",
      "stage": "new user",
      "tags": ["one", "two", "three"],
      "data": {
        "$canonical_identifier": "content/123",
        "$og_title": "Title from Deep Link",
        "$og_description": "Description from Deep Link",
        "$og_image_url": "http://www.lorempixel.com/400/400/",
        "$desktop_url": "http://www.example.com"
      }
    }
  ]'

Upon a successful request, the API responds with a 200 status with the newly created links in the response body. Example response body:

[
  {
    "url": "https://example.app.link/0AjuiLcpqF"
  },
  {
    "url": "https://example.app.link/5IULiLcpqF"
  }
]

Note: Bulk link creation via API is limited to creating 1000 links at a time.