Skip to content

Rallly is an open-source scheduling and collaboration tool designed to make organizing events and meetings easier.

📝 Announce the API on the blog (#3278)

Luke Vellabd24174fba8e
diff --git a/apps/landing/public/locales/en/home.json b/apps/landing/public/locales/en/home.json
index 9aebe410e..1588e87e7 100644
--- a/apps/landing/public/locales/en/home.json
+++ b/apps/landing/public/locales/en/home.json
@@ -1,4 +1,6 @@
{
+ "apiAnnouncement": "Introducing the Rallly API",
+ "apiBlogBadge": "New",
"assistantsDescription": "Whether you support one executive or a whole department, find a time that works across a dozen busy calendars without a single follow-up email. Share one link, watch the responses land, and lock in the slot everyone can make. Free, and nobody you invite needs an account.",
"assistantsFaqBranding": "Can polls carry our company branding?",
"assistantsFaqBrandingAnswer": "With <0>Rallly Pro</0> you can add your own logo and colours and remove Rallly attribution, so a poll you send to a board or a client looks like it came from your organization. Everything else is free to use.",
@@ -52,8 +54,6 @@
"doodleComparisonSelfHosting": "Self-hostable",
"doodleComparisonTimeZones": "Automatic time zone conversion",
"doodleComparisonTitle": "How Rallly compares to Doodle",
- "emailInvitesAnnouncement": "Introducing email invites",
- "emailInvitesBlogBadge": "New",
"ericJobTitle": "Executive Assistant at MIT",
"ericQuote": "“If your scheduling workflow lives in emails, I strongly encourage you to try and let Rallly simplify your scheduling tasks for a more organized and less stressful workday.”",
"faqAfterVoting": "What happens after everyone votes?",
diff --git a/apps/landing/public/static/images/rallly-api/create-poll-editor.svg b/apps/landing/public/static/images/rallly-api/create-poll-editor.svg
new file mode 100644
index 000000000..a3d1b193c
--- /dev/null
+++ b/apps/landing/public/static/images/rallly-api/create-poll-editor.svg
@@ -0,0 +1,82 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="800" height="450" viewBox="0 0 800 450">
+ <!-- An editor in the app's dark palette (zinc surfaces, indigo primary)
+ showing the create poll request from the post. The hero accent gradient
+ marks the active tab and the API URL. Indentation is positioned by x
+ offset: viewers disagree on whitespace inside SVG text. -->
+ <defs>
+ <linearGradient id="accent" x1="0" y1="0" x2="1" y2="0">
+ <stop offset="0" stop-color="#615fff"/>
+ <stop offset="1" stop-color="#8e51ff"/>
+ </linearGradient>
+ <clipPath id="window"><rect x="24" y="24" width="752" height="402" rx="12"/></clipPath>
+ </defs>
+ <rect width="800" height="450" fill="#18181b"/>
+ <g clip-path="url(#window)">
+ <rect x="24" y="24" width="752" height="402" fill="#1f1f22"/>
+ <rect x="24" y="24" width="168" height="402" fill="#1b1b1e"/>
+ <line x1="192.5" y1="24" x2="192.5" y2="426" stroke="#3f3f46"/>
+ <rect x="24" y="24" width="752" height="38" fill="#1b1b1e"/>
+ <line x1="24" y1="62.5" x2="776" y2="62.5" stroke="#3f3f46"/>
+ <circle cx="46" cy="43" r="5.5" fill="#3f3f46"/>
+ <circle cx="64" cy="43" r="5.5" fill="#3f3f46"/>
+ <circle cx="82" cy="43" r="5.5" fill="#3f3f46"/>
+ <rect x="193" y="24" width="150" height="38" fill="#1f1f22"/>
+ <rect x="193" y="60" width="150" height="2.5" fill="url(#accent)"/>
+ <text x="212" y="47" font-family="system-ui, -apple-system, 'Segoe UI', sans-serif" font-size="12.5" fill="#e4e4e7">create-poll.ts</text>
+ <text x="362" y="47" font-family="system-ui, -apple-system, 'Segoe UI', sans-serif" font-size="12.5" fill="#71717a">results.ts</text>
+ <text x="44" y="88" font-family="system-ui, -apple-system, 'Segoe UI', sans-serif" font-size="11" font-weight="600" letter-spacing="0.6" fill="#71717a">EXPLORER</text>
+ <path d="M44 104 l4 4 -4 4" fill="none" stroke="#71717a" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+ <text x="54" y="112" font-family="system-ui, -apple-system, 'Segoe UI', sans-serif" font-size="12" fill="#a1a1aa">rallly-integration</text>
+ <path d="M58 128 l4 4 -4 4" fill="none" stroke="#71717a" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
+ <text x="68" y="136" font-family="system-ui, -apple-system, 'Segoe UI', sans-serif" font-size="12" fill="#a1a1aa">src</text>
+ <rect x="32" y="145" width="152" height="22" rx="5" fill="#27272a"/>
+ <rect x="72" y="151" width="8" height="10" rx="2" fill="none" stroke="#52525b"/>
+ <text x="86" y="160" font-family="system-ui, -apple-system, 'Segoe UI', sans-serif" font-size="12" fill="#e4e4e7">create-poll.ts</text>
+ <rect x="72" y="175" width="8" height="10" rx="2" fill="none" stroke="#52525b"/>
+ <text x="86" y="184" font-family="system-ui, -apple-system, 'Segoe UI', sans-serif" font-size="12" fill="#a1a1aa">results.ts</text>
+ <rect x="58" y="199" width="8" height="10" rx="2" fill="none" stroke="#52525b"/>
+ <text x="72" y="208" font-family="system-ui, -apple-system, 'Segoe UI', sans-serif" font-size="12" fill="#a1a1aa">.env</text>
+ <rect x="58" y="223" width="8" height="10" rx="2" fill="none" stroke="#52525b"/>
+ <text x="72" y="232" font-family="system-ui, -apple-system, 'Segoe UI', sans-serif" font-size="12" fill="#a1a1aa">package.json</text>
+ <g font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" font-size="12.5">
+ <text x="220" y="84" text-anchor="end" fill="#52525b">1</text>
+ <text x="236" y="84"><tspan fill="#c4b5fd">const </tspan><tspan fill="#d4d4d8">res</tspan><tspan fill="#71717a"> = </tspan><tspan fill="#c4b5fd">await </tspan><tspan fill="#d4d4d8">fetch</tspan><tspan fill="#71717a">(</tspan><tspan fill="url(#accent)">"https://api.rallly.co/v1/polls"</tspan><tspan fill="#71717a">, {</tspan></text>
+ <text x="220" y="102" text-anchor="end" fill="#52525b">2</text>
+ <text x="251" y="102"><tspan fill="#e4e4e7">method</tspan><tspan fill="#71717a">: </tspan><tspan fill="#a5b4fc">"POST"</tspan><tspan fill="#71717a">,</tspan></text>
+ <text x="220" y="120" text-anchor="end" fill="#52525b">3</text>
+ <text x="251" y="120"><tspan fill="#e4e4e7">headers</tspan><tspan fill="#71717a">: {</tspan></text>
+ <text x="220" y="138" text-anchor="end" fill="#52525b">4</text>
+ <text x="266" y="138"><tspan fill="#e4e4e7">Authorization</tspan><tspan fill="#71717a">: </tspan><tspan fill="#a5b4fc">`Bearer </tspan><tspan fill="#a1a1aa">${</tspan><tspan fill="#d4d4d8">process</tspan><tspan fill="#71717a">.</tspan><tspan fill="#d4d4d8">env</tspan><tspan fill="#71717a">.</tspan><tspan fill="#d4d4d8">RALLLY_API_KEY</tspan><tspan fill="#a1a1aa">}</tspan><tspan fill="#a5b4fc">`</tspan><tspan fill="#71717a">,</tspan></text>
+ <text x="220" y="156" text-anchor="end" fill="#52525b">5</text>
+ <text x="266" y="156"><tspan fill="#a5b4fc">"Content-Type"</tspan><tspan fill="#71717a">: </tspan><tspan fill="#a5b4fc">"application/json"</tspan><tspan fill="#71717a">,</tspan></text>
+ <text x="220" y="174" text-anchor="end" fill="#52525b">6</text>
+ <text x="251" y="174"><tspan fill="#71717a">},</tspan></text>
+ <text x="220" y="192" text-anchor="end" fill="#52525b">7</text>
+ <text x="251" y="192"><tspan fill="#e4e4e7">body</tspan><tspan fill="#71717a">: </tspan><tspan fill="#d4d4d8">JSON</tspan><tspan fill="#71717a">.</tspan><tspan fill="#d4d4d8">stringify</tspan><tspan fill="#71717a">({</tspan></text>
+ <text x="220" y="210" text-anchor="end" fill="#52525b">8</text>
+ <text x="266" y="210"><tspan fill="#e4e4e7">title</tspan><tspan fill="#71717a">: </tspan><tspan fill="#a5b4fc">"Team offsite"</tspan><tspan fill="#71717a">,</tspan></text>
+ <text x="220" y="228" text-anchor="end" fill="#52525b">9</text>
+ <text x="266" y="228"><tspan fill="#e4e4e7">kind</tspan><tspan fill="#71717a">: </tspan><tspan fill="#a5b4fc">"date"</tspan><tspan fill="#71717a">,</tspan></text>
+ <text x="220" y="246" text-anchor="end" fill="#52525b">10</text>
+ <text x="266" y="246"><tspan fill="#e4e4e7">options</tspan><tspan fill="#71717a">: [</tspan></text>
+ <text x="220" y="264" text-anchor="end" fill="#52525b">11</text>
+ <text x="281" y="264"><tspan fill="#71717a">{ </tspan><tspan fill="#e4e4e7">date</tspan><tspan fill="#71717a">: </tspan><tspan fill="#a5b4fc">"2026-10-05"</tspan><tspan fill="#71717a"> },</tspan></text>
+ <text x="220" y="282" text-anchor="end" fill="#52525b">12</text>
+ <text x="281" y="282"><tspan fill="#71717a">{ </tspan><tspan fill="#e4e4e7">date</tspan><tspan fill="#71717a">: </tspan><tspan fill="#a5b4fc">"2026-10-06"</tspan><tspan fill="#71717a"> },</tspan></text>
+ <text x="220" y="300" text-anchor="end" fill="#52525b">13</text>
+ <text x="281" y="300"><tspan fill="#71717a">{ </tspan><tspan fill="#e4e4e7">date</tspan><tspan fill="#71717a">: </tspan><tspan fill="#a5b4fc">"2026-10-07"</tspan><tspan fill="#71717a"> },</tspan></text>
+ <text x="220" y="318" text-anchor="end" fill="#52525b">14</text>
+ <text x="266" y="318"><tspan fill="#71717a">],</tspan></text>
+ <text x="220" y="336" text-anchor="end" fill="#52525b">15</text>
+ <text x="251" y="336"><tspan fill="#71717a">}),</tspan></text>
+ <text x="220" y="354" text-anchor="end" fill="#52525b">16</text>
+ <text x="236" y="354"><tspan fill="#71717a">});</tspan></text>
+ <text x="220" y="372" text-anchor="end" fill="#52525b">17</text>
+ <text x="220" y="390" text-anchor="end" fill="#52525b">18</text>
+ <text x="236" y="390"><tspan fill="#c4b5fd">const </tspan><tspan fill="#71717a">{ </tspan><tspan fill="#d4d4d8">data</tspan><tspan fill="#71717a"> } = </tspan><tspan fill="#c4b5fd">await </tspan><tspan fill="#d4d4d8">res</tspan><tspan fill="#71717a">.</tspan><tspan fill="#d4d4d8">json</tspan><tspan fill="#71717a">();</tspan></text>
+ <text x="220" y="408" text-anchor="end" fill="#52525b">19</text>
+ <text x="236" y="408"><tspan fill="#d4d4d8">console</tspan><tspan fill="#71717a">.</tspan><tspan fill="#d4d4d8">log</tspan><tspan fill="#71717a">(</tspan><tspan fill="#d4d4d8">data</tspan><tspan fill="#71717a">.</tspan><tspan fill="#e4e4e7">inviteUrl</tspan><tspan fill="#71717a">);</tspan></text>
+ </g>
+ </g>
+ <rect x="24.5" y="24.5" width="751" height="401" rx="12" fill="none" stroke="#3f3f46"/>
+</svg>
diff --git a/apps/landing/src/app/[locale]/(main)/page.tsx b/apps/landing/src/app/[locale]/(main)/page.tsx
index e7e1001d5..a3043934a 100644
--- a/apps/landing/src/app/[locale]/(main)/page.tsx
+++ b/apps/landing/src/app/[locale]/(main)/page.tsx
@@ -43,21 +43,16 @@ export default async function Page(props: {
descriptionClassName="max-w-[600px]"
announcement={
<HeroAnnouncement
- href="/blog/introducing-email-invites"
+ href="/blog/introducing-the-rallly-api"
badge={
- <Trans
- t={t}
- ns="home"
- i18nKey="emailInvitesBlogBadge"
- defaults="New"
- />
+ <Trans t={t} ns="home" i18nKey="apiBlogBadge" defaults="New" />
}
>
<Trans
t={t}
ns="home"
- i18nKey="emailInvitesAnnouncement"
- defaults="Introducing email invites"
+ i18nKey="apiAnnouncement"
+ defaults="Introducing the Rallly API"
/>
</HeroAnnouncement>
}
diff --git a/apps/landing/src/posts/introducing-the-rallly-api.md b/apps/landing/src/posts/introducing-the-rallly-api.md
new file mode 100644
index 000000000..80d7ab042
--- /dev/null
+++ b/apps/landing/src/posts/introducing-the-rallly-api.md
@@ -0,0 +1,49 @@
+---
+title: Introducing the Rallly API
+date: "2026-09-15"
+category: Product
+excerpt: Create polls, read results and close them from your own tools. The API is available now for Pro spaces on Rallly Cloud.
+---
+
+Rallly has had a small API behind a flag for a while. A handful of people have been using it to create polls from their own systems, and their feedback has shaped what ships today. It is now open to every Pro space on Rallly Cloud.
+
+![A code editor showing a fetch request that creates a date poll with three options through the Rallly API](/static/images/rallly-api/create-poll-editor.svg)
+
+## What it does
+
+The API covers the full life of a poll:
+
+- **Create a poll** with either whole days or time slots. Time slots can be listed one by one or generated from a schedule, for example every 30 minutes between 9 and 5 on weekdays for the next two weeks.
+- **List and read polls**, filtered by status, with the same options and settings you see in the app.
+- **Read results**: vote counts per option and which options are leading.
+- **Read participants** and how each one voted.
+- **Close or delete** a poll once a decision has been made.
+
+Every request is scoped to one space. The API key identifies the space, so anything you create or read belongs to it.
+
+## Getting started
+
+The space owner creates a key in **Settings → API keys**. Requests carry it as a bearer token:
+
+```sh
+curl https://api.rallly.co/v1/polls \
+ -H "Authorization: Bearer $RALLLY_API_KEY" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "title": "Team offsite",
+ "kind": "date",
+ "options": [
+ { "date": "2026-10-05" },
+ { "date": "2026-10-06" },
+ { "date": "2026-10-07" }
+ ]
+ }'
+```
+
+The response includes an `inviteUrl` to share with participants and an `adminUrl` for the organizer. Each space can make 60 requests a minute.
+
+The [API reference](https://support.rallly.co/api-reference/introduction) has every endpoint with request and response examples, and the OpenAPI document is available if you would rather generate a client.
+
+## What comes next
+
+Polling for results works, but it is not how most integrations want to run. Webhooks for poll events are planned so your system hears about a new response or a closed poll as it happens. There is no date for that yet. If you build something on the API, I would like to hear what you are building and what gets in the way, at [[email protected]](mailto:[email protected]).