API & Integrations

14. API & Integrations

The API & Integrations section contains tools for programmatic integration of 7stamp with your external systems — CRM, POS, ERP, analytics, messenger bots.

API Keys

The main page of the section is the API key list. Columns:

• Name — key name (usually matches the linked Staff name).
• Login — the Staff login the key is tied to.
• API Key — the key itself (starts with 7loc_sc_..., hidden by default, copyable with one click).
• Status — Active.
• 🔄 — regenerate the key.
• 🗑️ — delete the key.

Creating an API key

Tap + ADD API KEY — the Generate API Key popup opens:

• Scanner — dropdown to pick the Staff Login the key will be bound to (one Staff can have one key).
• Buttons CANCEL / GENERATE.

After GENERATE the key is created and appears in the list. Copy it immediately — the full key may not be shown again.

What you can do via the API

• Issue a card to a customer by email/phone.
• Add a stamp to a specific customer.
• Issue a voucher (templated or custom, with Redeem Code).
• Redeem a voucher (if you work via your own POS).
• Read state of the card, progress, history.
• Subscribe to Webhooks to receive events in real time.

Webhooks

Webhooks send card events to an external system. Supported (see the event glossary):

• card_issued, card_saved, card_opened.
• stamp_added.
• goal_reached, reward_issued.
• voucher_issued, voucher_redeemed, voucher_expired.
• lottery_played (with the result).
• birthday_reached.
• inactivity_trigger.
• campaign_sent.

Webhook payload example

{
  "event": "voucher_redeemed",
  "timestamp": "2026-05-11T12:34:56Z",
  "business_id": "b_123",
  "location_id": "loc_45",
  "customer": {
    "id": "c_789",
    "wallet_pass_id": "wp_abc",
    "language": "en"
  },
  "card": { "id": "card_001", "goal_index": 2 },
  "voucher": {
    "id": "v_555",
    "type": "voucher",
    "redeem_code": "FREECOFFEE",
    "redeem_code_formats": ["text", "qr", "barcode"],
    "status": "redeemed",
    "redeemed_via": "staff_scanner"
  }
}

Ready-made POS integrations

• Poster — ready-made integration, connects in a few clicks.
• Serve — ready-made integration.
• Other tills — made on request. Free if technically feasible (i.e., your till exposes an open API or Webhooks).

Messenger broadcasts via 7loc.com

For WhatsApp, Telegram, Viber broadcasts, the 7loc.com integration is connected. Once active, the “messengers” channel becomes available in Campaigns next to PUSH and Email.

No-code scenarios: Zapier and Make

7stamp API + Webhooks work with Zapier and Make (Integromat), letting you build scenarios without coding:

• “When voucher_redeemed — add a tag in Mailchimp”.
• “When goal_reached — send a notification to Slack”.
• “When birthday_reached — create a task in CRM”.

---