Show Your Events on Your Own Website

Who It Is For

The Content API is available on paid eventcloud plans, so it starts working the moment your free trial becomes a subscription. You'll also need someone who can build or edit your website, such as your web agency or developer. If you use WordPress, a plugin is on the way (see the questions below).

What You Can Show

• Event details: name, dates, venue, description, images, colours and social links

• The agenda: sessions with times, rooms and tracks

• Speakers with their public biographies and photos

• Tickets and prices, including early-bird prices that start or end on a date

• FAQs, sponsors and venues

It only shows what your public event website already shows. Draft events stay private. Cancelled events are included, marked as cancelled, so your site can say so.

Create a Key

1. In eventcloud, go to Integrations › Content API.

2. Select Create key and give it a name, such as the name of your website.

3. Copy the key straight away. For your security we show it only once.

Owners and admins can create keys. You can have up to ten at a time, so you can give each website its own.

Give Your Web Agency the Docs

The documentation is on the same page, under Documentation. It's also public, so you can send this link to anyone: app.eventcloud.io/docs/content-api. It never shows your keys. Send the key separately and privately, for example through a password manager.

Developers will find everything they need there: the API's address (https://api.eventcloud.io/v1), every endpoint, and a machine-readable description of each response (OpenAPI at api.eventcloud.io/v1/openapi.json, plus JSON Schema) that their tools can turn into ready-made code.

Your Website Needs to Remember the Answers

This is the one thing your developer must get right. Your website should ask eventcloud for the content from its server, keep a copy for at least five minutes, and show visitors that copy. It shouldn't ask eventcloud every time someone opens a page. This keeps your site fast, keeps ours steady, and means your site still works if either of us has a bad moment. The documentation shows how, and there are limits in place if a site asks too often.

Keep Your Key Secret

Your key lets whoever holds it read your public event content, so treat it like a password.

• Keep it on your website's server. Don't put it in page code that visitors can see.

• Don't post it in a public place, such as a public code repository.

• Keys that start with ecc_live_ work on your real account. Keys that start with ecc_test_ are for our test site only.

Rotate or Revoke a Key

• Rotate if you think a key may have leaked, or when someone leaves your agency. You get a new secret straight away and the old one stops working immediately. Put the new one on your website.

• Revoke when you no longer need a key. It stops for good.

Both are on the Integrations › Content API page.

If Your Subscription Lapses

If your plan ends or payment fails for good, your keys pause. Your website's requests are refused, and well-built sites carry on showing their last saved copy. We email the person who created the key the first time this happens, and the page in eventcloud shows a banner saying why. You don't need to create anything new: when your subscription is active again, the same keys work again.

Languages

If your event is offered in more than one language, your website can ask for any of them. If it asks for a language the event doesn't offer, it gets the event's main language, and the response says so.

Questions

Can I sell tickets on my own website? Your site can show ticket names and prices, and buying happens on eventcloud's secure checkout. Each ticket group comes with a link that takes visitors there.

Can I show how many tickets are left, or "sold out"? Your site shows ticket names, prices and price windows today, and visitors who pick a ticket that has sold out are told on the checkout page. Want live availability on your own site as well? Tell us at [email protected].

Is attendee data available? No, never. The Content API only shows what's already public on your event website. It has no attendee, order or contact details, and it can't change anything in eventcloud.

Can I show exhibitors, or something else that isn't listed above? Tell us what you need at [email protected] and we'll let you know when it lands.

Is there a WordPress plugin? It's planned. It will use the Content API, so a key made now will work with it.

A key stopped working. What should I check? It may have been revoked or rotated, your plan may have changed, or the key may be from our test site. If your website was asking too often, it may also have been slowed down briefly; waiting a minute puts that right.

Does it cost extra? No. It's included on paid plans.

Still stuck? Contact [email protected].