VerticalResponse API Quickstart Guide

Welcome! If you want to connect to the VerticalResponse API, you are in the right place. This guide walks you through the process step by step.

Step 1: Create your VR2 account

Visit verticalresponse.com and click Start Free Trial. Complete the sign up to create your account.

Step 2: Request API access

Go to the support form and choose the API access request option. Include your business name and the email address for your VR2 account.

Step 3: Receive your credentials

We will email you your unique Client ID, your Client Secret, and a link to the API documentation. Keep your credentials safe.

Step 4: Authenticate

Use your credentials to get an access token.

curl -X POST "https://api-vr2.verticalresponse.com/api/v1/authorize" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=<YOUR_CLIENT_ID>" \
  -d "client_secret=<YOUR_CLIENT_SECRET>"

You will receive an access_token that is valid for a short time.

Step 5: Make your first call

Try listing your contacts.

curl -X GET "https://api-vr2.verticalresponse.com/api/v1/contacts" \
  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>"

Step 6: Explore and test

Use the API docs at https://apidocs.verticalresponse.com/. Start with the Authorize endpoint at https://apidocs.verticalresponse.com/#/Auth/post_api_v1_authorize.

Need help?

Contact Support: https://support.verticalresponse.com/hc/en-us/requests/new?

You are connected. Now you can explore campaigns, lists, and more.