Eventyvo Connect

Getting started

Choose your website model — embeds-only or secure Eventyvo data access — then ship.

Overview

For organizers with an existing website, Eventyvo Connect supports two goals:

  1. Model A — Put Eventyvo features on your site while data stays in Eventyvo (no Connect key in the browser).
  2. Model B — Same features plus securely use related data already stored in Eventyvo (registrations, payments, check-ins) from your servers.

Read Two website integration models, then follow the steps below. Prefer the guided Integration quickstart.

Public docs are readable without login. The embed builder and developer portal require sign-in.

Step 1 — Sign in on docs

Use Sign in on this site (docs.eventyvo.com) with your Eventyvo account. Manage Connect keys, webhooks, and the embed builder on the Developer portal — you do not need the organizer app for Connect setup.

If shared cookies are configured (.eventyvo.com), an existing app session may already authenticate you here.

Step 2 — Subscribe

Build a customized offer with the modules you need. Add API capacity if you will use Model B (REST or webhooks). Pay at pay.eventyvo.com.

Step 3 — Model A: embed features (no key in the browser)

Canonical host: https://docs.eventyvo.com

<div data-eventyvo="event-card" data-event-slug="your-event-slug" data-theme="light"></div>
<script async src="https://docs.eventyvo.com/embed/v1/eventyvo-embed.js"></script>

Widgets: Embeds overview. Builder: /tools/embed-builder. Full event site: Subwebsite.

Stop here if you only need features on the site and will run ops entirely in the Eventyvo dashboard.

Step 4 — Model B: Connect API key (server only)

On /developer → Connect API keys → Create key (or copy a rotated key after buy/renew).

  • Plaintext shown once — store in server env vars
  • Never in frontend bundles
  • Unlocks your company’s related Eventyvo data only

Test events may use ev_test_* — see Sandbox.

Step 5 — Model B: server REST

curl -H "X-API-KEY: ev_live_xxxxxxxx" \
  "https://api.eventyvo.com/api/v1/integrations/zapier/events"

Reference: Connect REST. Organizer GraphQL is not part of Connect.

Step 6 — Model B: webhooks

Configure URLs and events on /developer → Webhooks (FORM_SUBMISSION, PAYMENT_SUCCESS, ATTENDANT_CHECKED_IN, …). Verify signatures with @eventyvo/embed — Verification · Payloads.

Security

Follow the Security checklist before going live with Model B.

Next steps