GripzDevelopers
Sign in
GripzDevelopers

Put Gripz in your product, and take your data with you

One script tag installs the widget. The REST API, webhooks and MCP server use the same objects, the same IDs and the same permissions as the app.One script tag installs the widget. The REST API, webhooks and MCP server use the same objects and permissions as the app.

Start the web quickstartOpen the REST referenceOpen the REST reference

Base URL for your region: https://api.eu.gripz.example/v1

<script>
  (function (w, d) {
    w.Gripz = w.Gripz || function () {
      (w.Gripz.q = w.Gripz.q || []).push(arguments);
    };
    var s = d.createElement('script');
    s.async = true;
    s.src = 'https://widget.eu.gripz.example/v1/loader.js';
    d.head.appendChild(s);
  })(window, document);

  Gripz('boot', { workspaceId: 'tw_8f2k' });
</script>
npm install @gripz/web

import { Gripz } from '@gripz/web';

Gripz('boot', { workspaceId: 'tw_8f2k' });

What you can build

Five building blocks. Each one works on every plan, including Free.

  • Install the widget

    A loader under 10 KB that boots the messenger on any site or single-page app.

    Web SDK

  • Identify your users

    Pass a signed JWT so conversations follow a person across devices and nobody can pose as them.

    Identity

  • Call REST, listen to webhooks

    Read and write conversations, contacts, tickets and articles. Get a signed event when anything changes.

    REST API

  • Connect an AI tool

    The MCP server gives assistants scoped, audited access. Reads by default, and writes only as notes and drafts a person reviews.

    MCP

  • Export your data

    Everything in open formats, with message bodies and attachments, in one archive.

    Export spec

Quickstarts

Each guide ends with a check that confirms Gripz received your first event.

  • SnippetPaste one script tag2 min
  • npmReact, Vue, Svelte and other SPAs5 min
  • WordPressPlugin, no code3 min
  • ShopifyApp embed with customer identity3 min
  • GTMGoogle Tag Manager template4 min
  • RESTYour first authenticated call5 min
  • WebhooksReceive and verify an event10 min
  • MCPConnect an AI tool5 min

Leave whenever you like

Export is available on every plan, during suspension, after cancellation and for 90 days after a workspace is closed. It is never charged. Message bodies are always included.

Read the export format spec
tidewater-export-2026-10-02/
├── manifest.json
├── conversations/messages.jsonl
├── contacts.jsonl
├── articles/*.md
└── attachments/

Latest changes

See the full changelog
  • 29 Sep 2026AddedMCP server: create_draft_reply tool, held for human review
  • 22 Sep 2026ChangedWebhook retries now run for 72 hours with a replay endpoint
  • 15 Sep 2026DeprecatedOffset pagination on list endpoints. Works until 1 March 2028

What you can build

Quickstarts

Leave whenever you like

Export works on every plan, during suspension and for 90 days after a workspace is closed. It is never charged. Message bodies are always included.

Read the export format spec

Latest changes

  • 29 Sep 2026 · AddedMCP server: create_draft_reply tool, held for human review
  • 22 Sep 2026 · ChangedWebhook retries now run for 72 hours
  • 15 Sep 2026 · DeprecatedOffset pagination. Works until 1 March 2028
See the full changelog