{"article":{"id":34095075685143,"url":"https://verticalresponsehelp.zendesk.com/api/v2/help_center/en-us/articles/34095075685143.json","html_url":"https://support.verticalresponse.com/hc/en-us/articles/34095075685143-VerticalResponse-API-Quickstart-Guide","author_id":1500479198881,"comments_disabled":true,"draft":false,"promoted":false,"position":0,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":29907326629911,"created_at":"2025-08-11T14:37:28Z","updated_at":"2025-08-13T14:24:04Z","name":"VerticalResponse API Quickstart Guide","title":"VerticalResponse API Quickstart Guide","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2025-08-12T19:59:12Z","user_segment_id":null,"permission_group_id":1500000025162,"content_tag_ids":[],"label_names":[],"body":"<meta charset=\"utf-8\">\n  <p>\n    Welcome! If you want to connect to the VerticalResponse API, you are in the\n    right place. This guide walks you through the process step by step.\n  </p>\n  <h3 id=\"h_01K2CSPCBDPY6GXZAYW4G18WSK\">Step 1: Create your VR2 account</h3>\n  <p>\n    Visit <a href=\"https://verticalresponse.com/\">verticalresponse.com</a> and\n    click Start Free Trial. Complete the sign up to create your account.\n  </p>\n  <h3 id=\"h_01K2CSPCBDR7FE7BTEJ005G1GQ\">Step 2: Request API access</h3>\n  <p>\n    Go to the\n    <a href=\"https://support.verticalresponse.com/hc/en-us/requests/new?\">support form</a>\n    and choose the API access request option. Include your business name and\n    the email address for your VR2 account.\n  </p>\n  <h3 id=\"h_01K2CSPCBDCH8WX9VJP0H0C61M\">Step 3: Receive your credentials</h3>\n  <p>\n    We will email you your unique Client ID, your Client Secret, and a link to\n    the API documentation. <strong>Keep your credentials safe.</strong>\n  </p>\n  <h3 id=\"h_01K2CSPCBDHC3N0YAFMZ5HF8D0\">Step 4: Authenticate</h3>\n  <p>Use your credentials to get an access token.</p>\n  <pre><code>curl -X POST \"https://api-vr2.verticalresponse.com/api/v1/authorize\" \\\n  -H \"Content-Type: application/x-www-form-urlencoded\" \\\n  -d \"grant_type=client_credentials\" \\\n  -d \"client_id=&lt;YOUR_CLIENT_ID&gt;\" \\\n  -d \"client_secret=&lt;YOUR_CLIENT_SECRET&gt;\"\n</code></pre>\n  <p>\n    You will receive an access_token that is valid for a short time.\n  </p>\n  <h3 id=\"h_01K2CSPCBD6CTPD72HEFTW6P2P\">Step 5: Make your first call</h3>\n  <p>Try listing your contacts.</p>\n  <pre><code>curl -X GET \"https://api-vr2.verticalresponse.com/api/v1/contacts\" \\\n  -H \"Authorization: Bearer &lt;YOUR_ACCESS_TOKEN&gt;\"\n</code></pre>\n  <br>\n  <h3 id=\"h_01K2CSPCBDASSRFEEXS4149EWF\">Step 6: Explore and test</h3>\n  <p>\n    Use the API docs at\n    <a href=\"https://apidocs.verticalresponse.com/\">https://apidocs.verticalresponse.com/</a>.\n    Start with the Authorize endpoint at\n    <a href=\"https://apidocs.verticalresponse.com/#/Auth/post_api_v1_authorize\">https://apidocs.verticalresponse.com/#/Auth/post_api_v1_authorize</a>.\n  </p>\n  <h3 id=\"h_01K2CSPCBD1G4EHFAZ8F88HNSC\">Need help?</h3>\n  <p>\n    Contact Support:\n    <a href=\"https://support.verticalresponse.com/hc/en-us/requests/new?\">https://support.verticalresponse.com/hc/en-us/requests/new?</a>\n  </p>\n  <p>\n    You are connected. Now you can explore campaigns, lists, and more.\n  </p>","user_segment_ids":[]}}