Skip to main content
Matchly
Marketing

API access

Matchly has a read-only API for your own automations. You create the tokens in the app. Nothing outside the app can change your data through it.

What you can read​

  • quizzes: your quizzes
  • responses: submitted answers and captured leads
  • products: the products a quiz recommends

Every endpoint answers GET requests only. A token can read these resources for your shop and nothing else.

API access is in the app settings.

Create a token​

  1. In the app, open Settings and then API Access.
  2. Select Generate Token.
  3. Give the token a name you will recognise later, for example "Make.com Integration".
  4. Copy the token when it is shown. It is shown once. If you lose it, revoke it and generate a new one.

A shop can have 3 active tokens at a time. The token list shows when each token was created, when it was last used and how many requests it made.

Use a token​

Send the token in the Authorization header of each request. The API Reference on the same page lists the endpoints, pagination and filtering, the response format and the rate limits for your shop.

Common errors:

  • No Authorization header: the request has no token.
  • Token invalid, revoked or expired: generate a new token.
  • Resource type not available: the resource is not one of the ones listed above.
  • Only GET is supported: the API does not write.
  • Too many requests: slow down and retry.

Revoke a token​

Open Settings, API Access, select the token and choose Revoke Token. Anything still using it stops working straight away.

AI assistants​

The same access is exposed as tools an AI assistant can call: list_quizzes, get_quiz, get_quiz_stats, list_responses.

Other ways to connect​

See the settings reference for the integrations this app supports.