API Reference

The Gro API lets you programmatically manage subscriptions, customers, entities, billing, and more. All endpoints are documented below, auto-generated from our OpenAPI specification.

Base URL

https://api.usegro.co

Try it in the browser

Open the interactive API explorer to browse every endpoint and send real requests with your API key.

Authentication

All requests require an API key. See API Keys and Authentication for details.

Endpoints

Browse the full endpoint reference in the sidebar under Endpoints. Each endpoint includes request/response schemas, parameters, and example payloads.

You can also download the OpenAPI spec directly:

• Interactive API explorer
• OpenAPI JSON
• OpenAPI YAML

Import an HTML email

Built an email in another editor, such as Stripo? Send its HTML to Gro and it becomes a template you can use in campaigns and flows.

curl -X POST https://api.usegro.co/api/templates/import \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Spring sale",
    "subject": "Our spring sale is on",
    "preheader": "Up to 30% off",
    "html": "<!DOCTYPE html><html>...</html>"
  }'

• name and html are required. subject and preheader are optional.
• CSS is inlined and the email is kept as one HTML block, so it looks the same as in the editor you built it in.
• Images stay where they are hosted.
• If the HTML has no {{ unsubscribe_link }}, Gro adds an unsubscribe footer.
• The response is the new template, including its id.