Skip to content
New: offer, price and checkout tests, each read from your Shopify orders. See what shipped
GROWTH DEPT.CRO

The Growth Dept CRO API

Create draft tests, start and end them, read results and run email and SMS message tests from your own scripts and agents.

  • One key per brand, with the scopes you choose
  • The same results the app shows
  • Every problem listed when a draft does not validate
Book a callAPI reference
Create an API key in the brand's settings and choose its scopes. Send it as a bearer token; the key names its brand. Drafts change nothing on the storefront until a key with the start scope starts them.

At a glance

Does Growth Dept CRO work with Growth Dept CRO API?

What can it do?

List and read tests, create drafts, pause, start, resume and end tests, read results, and create and run message tests.

Which scopes?

tests:read, tests:write, tests:start and messages:write.

Which test types?

Every type the app has: split URL, content, theme, shipping, flag, multivariate, offer, price, checkout and post-purchase.

What do results look like?

The same object the app's results tab reads, cached for five minutes, with fresh=1 to recompute.

Can I preview a draft?

Yes. Each test comes with one preview link per group, which marks the visit as QA so it never counts.

How it works

How Growth Dept CRO API and Growth Dept CRO work together

Make a key

Settings, API keys. Choose only the scopes the script needs.

Create a draft

POST /api/v1/tests with the test as JSON. Problems come back as a list.

Start and read

Start it with a key that has tests:start, then read /results.

Get started

To get started

  1. 01

    Create a key

    In the brand's settings, with the scopes you need.

  2. 02

    Draft a test

    Send the test as JSON; fix anything the answer lists.

  3. 03

    Start it

    With tests:start, once the storefront runtime is on.

What it works with

Every test typeEmail and SMS message testsScoped keys per brand

FAQ

Growth Dept CRO API questions

What happens if a step does not apply?
The API answers 409 and says why, for example starting a test that is already running or a test type your store cannot run yet.
Can a key read other brands?
No. A key names one brand and reaches only that brand's data.

More integrations

ShopifyNext.js and headlessCloudflare WorkersKlaviyoSlackGoogle Analytics 4Microsoft ClarityGrowth Dept MTAGrowth Dept ACRGrowth Dept agents

Find out what is worth testing on your store.

Book a 45-minute call with the Growth Dept team. We look at your store and your traffic, and tell you which tests to run first.

Book a call