{"id":20452,"date":"2026-10-14T04:42:26","date_gmt":"2026-10-14T04:42:26","guid":{"rendered":"https:\/\/www.hostinger.com\/support\/?p=20452"},"modified":"2026-10-14T04:45:01","modified_gmt":"2026-10-14T04:45:01","slug":"hostinger-reach-how-to-use-the-reach-public-api","status":"publish","type":"post","link":"https:\/\/www.hostinger.com\/support\/hostinger-reach-how-to-use-the-reach-public-api\/","title":{"rendered":"Hostinger Reach: How to use the Reach public API"},"content":{"rendered":"<p>The <a data-click-id=\"hgr-post-content-link-hostinger-reach\" href=\"https:\/\/www.hostinger.com\/email-marketing\">Hostinger Reach<\/a> public API lets you create, update, and organize Reach contacts and segments programmatically and build custom integrations with your own systems. There are four steps to using the Reach public API: generate an API token in the Hostinger dashboard, pass it in the Authorization header, retrieve your Reach profile ID, and call the contacts and segments endpoints.<\/p><h3>Before you start<\/h3><p>The Reach public API is best for custom and advanced setups. To manage Reach contacts by asking an AI assistant instead, use <a data-click-id=\"hgr-post-content-link-hostinger-connector\" href=\"https:\/\/www.hostinger.com\/support\/hostinger-reach-how-to-manage-reach-with-hostinger-connector\/\">Hostinger Connector<\/a>.<\/p><h2 id=\"h-open-the-reach-public-api-page-in-hostinger-reach\">Open the Reach public API page in Hostinger Reach<\/h2><ol>\n<li>In the Reach dashboard, click <a data-click-id=\"hgr-post-content-link-integrations\" href=\"https:\/\/www.hostinger.com\/support\/hostinger-reach-how-to-connect-integrations\/\"><strong>Integrations<\/strong> <\/a>in the left sidebar.<\/li>\n<li>On the <strong>Reach public API<\/strong> card, click <strong>Learn more<\/strong>.<br>\n<img decoding=\"async\" class=\"alignnone size-full wp-image-20465\" src=\"https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-14_11-40.png\" alt=\"\" width=\"1696\" height=\"768\" srcset=\"https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-14_11-40.png 1696w, https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-14_11-40-300x136.png 300w, https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-14_11-40-1024x464.png 1024w, https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-14_11-40-768x348.png 768w, https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-14_11-40-1536x696.png 1536w\" sizes=\"(max-width: 1696px) 100vw, 1696px\" \/><\/li>\n<\/ol><p>The Reach public API page lists the four setup steps, each with a button that opens the relevant Hostinger dashboard page or API documentation. Click <strong>API doc<\/strong> on the card instead to go straight to the API reference.<\/p><p><img decoding=\"async\" class=\"alignnone size-full wp-image-20466\" src=\"https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-14_11-40_1.png\" alt=\"\" width=\"602\" height=\"777\" srcset=\"https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-14_11-40_1.png 602w, https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-14_11-40_1-232x300.png 232w\" sizes=\"(max-width: 602px) 100vw, 602px\" \/><\/p><h2 id=\"h-step-1-generate-a-hostinger-api-token-for-the-reach-public-api\">Step 1 &ndash; Generate a Hostinger API token for the Reach public API<\/h2><p>A single Hostinger API token gives access to the Reach public API and other Hostinger APIs.<\/p><ol>\n<li>Click <strong>Generate API token<\/strong>. The <strong>API<\/strong> page of the Hostinger dashboard opens.<\/li>\n<li>Select the <strong>API tokens<\/strong> tab.<\/li>\n<li>Click <strong>New token<\/strong> and follow the prompts to create your token.<br>\n<img decoding=\"async\" class=\"alignnone size-full wp-image-19809\" src=\"https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-07_17-17.png\" alt=\"\" width=\"1689\" height=\"777\" srcset=\"https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-07_17-17.png 1689w, https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-07_17-17-300x138.png 300w, https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-07_17-17-1024x471.png 1024w, https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-07_17-17-768x353.png 768w, https:\/\/www.hostinger.com\/support\/wp-content\/uploads\/sites\/55\/2026\/10\/2026-10-07_17-17-1536x707.png 1536w\" sizes=\"(max-width: 1689px) 100vw, 1689px\" \/><\/li>\n<\/ol><p><strong>NOTE<\/strong><\/p><ul>\n<li>Treat your API token like a password, since it grants access to Reach and other Hostinger APIs.<\/li>\n<\/ul><h2 id=\"h-step-2-authenticate-reach-public-api-requests\">Step 2 &ndash; Authenticate Reach public API requests<\/h2><p>Pass your API token in the Authorization header of each request to securely call Reach and other Hostinger endpoints. See the <a data-click-id=\"hgr-post-content-link-hostinger-api-authentication-guide\" href=\"https:\/\/docs.hostinger.com\/api-reference\/overview#description\/authentication\" target=\"_blank\" rel=\"noopener\">Hostinger API authentication guide<\/a> for the header format.<\/p><h2 id=\"h-step-3-get-your-reach-profile-id\">Step 3 &ndash; Get your Reach profile ID<\/h2><p>Retrieve all Reach profiles linked to your account with <code>GET \/api\/reach\/v1\/profiles<\/code>, then select the profile you want to work with. See the <a data-click-id=\"hgr-post-content-link-reach-profiles-endpoint-reference\" href=\"https:\/\/docs.hostinger.com\/api-reference\/overview#tag\/reach-profiles\/GET\/api\/reach\/v1\/profiles\" target=\"_blank\" rel=\"noopener\">Reach profiles endpoint reference<\/a> for request and response details.<\/p><h2 id=\"h-step-4-manage-reach-contacts-and-segments-via-the-api\">Step 4 &ndash; Manage Reach contacts and segments via the API<\/h2><p>Use your profile ID to create, update, and organize Reach contacts and segments. See the <a data-click-id=\"hgr-post-content-link-reach-contacts-endpoint-reference\" href=\"https:\/\/docs.hostinger.com\/api-reference\/overview#tag\/reach-contacts\/POST\/api\/reach\/v1\/contacts\" target=\"_blank\" rel=\"noopener\">Reach contacts endpoint reference<\/a> for <code>POST \/api\/reach\/v1\/contacts<\/code> and related endpoints.<\/p><p>With an API token and your Reach profile ID, your own systems can create and organize Hostinger Reach contacts and segments without manual imports.<\/p><p><strong>NOTE<\/strong><\/p><ul>\n<li>Combine the Hostinger API and Reach endpoints in n8n to automate workflows. Click <strong>Learn more<\/strong> in the <strong>Automate with n8n<\/strong> banner on the Reach public API page for details.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Manage Hostinger Reach contacts and segments programmatically with a Hostinger API token and the Reach public API.<\/p>\n","protected":false},"author":594,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"include_on_kodee":true,"footnotes":""},"categories":[296],"tags":[],"class_list":["post-20452","post","type-post","status-publish","format-standard","hentry","category-hostinger-reach"],"hreflangs":[],"include_on_kodee":true,"_links":{"self":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts\/20452","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/users\/594"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/comments?post=20452"}],"version-history":[{"count":3,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts\/20452\/revisions"}],"predecessor-version":[{"id":20470,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/posts\/20452\/revisions\/20470"}],"wp:attachment":[{"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/media?parent=20452"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/categories?post=20452"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.hostinger.com\/support\/wp-json\/wp\/v2\/tags?post=20452"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}