canonical: https://jentic.com/apis/getlaunchlist.com/getlaunchlist

# Getlaunchlist LaunchList API

The LaunchList API runs waitlist signups, referral programs, and email broadcasts for a product launch. It creates and updates contacts through the same submit pipeline the hosted signup page uses, so canonicalization, dedupe, referral credit, and automation enrollment all fire on an API call just as they do on a typed signup. It tracks each contact's referrals and live leaderboard position, mints and redeems invitations, and drafts, tests, and sends email broadcasts to segments of contacts. It is aimed at founders and growth teams automating a pre-launch waitlist and referral loop.

## For AI agents

Run a waitlist and referral program through LaunchList: add and update contacts, track referrals and leaderboard position, mint invitations, and draft and send email broadcasts to segments.

## Scope

Does not handle SMS, transactional receipts, or payment collection. Use for waitlist signups, referral tracking, and email broadcasts only.

## Capabilities

- Add and update contacts through the same submit pipeline that dedupes and credits referrals
- Track a contact's referrals and live leaderboard position
- Mint, redeem, and revoke invitations that grant waitlist access
- Draft, test, schedule, and send email broadcasts to segments of contacts
- Build segments from filters and tag contacts for targeting
- Bulk-import contacts and enroll them in automation sequences

## Use cases

### Agent-run waitlist signup and referral

An AI agent handling a new signup can call the LaunchList API through Jentic to add the contact, which triggers dedupe and referral credit automatically, then read back the contact's leaderboard position to show their standing. Jentic returns the create-contact operation from a natural-language query, so the agent runs the waitlist loop without reading the LaunchList reference first.

Example prompt: Create the contact from the signup details, then retrieve the contact's leaderboard position and return their current standing and referral count.

### Launch-day email broadcast

Draft a broadcast, send a test to the team, and then schedule or send it to a segment of waitlist contacts when a product launches. LaunchList keeps the broadcast lifecycle, prepare, send, pause, and resume, as separate operations so a workflow can stage the send safely before it goes out.

Example prompt: Create a broadcast draft, send a test to the team, then send the broadcast to the chosen segment and confirm it moved to the sent state.

### Invitation-gated early access

Mint invitation codes for early access, let contacts redeem them, and revoke codes that should no longer work. Combined with segments, a growth team can open access in controlled waves rather than all at once.

Example prompt: Mint an invitation for the contact, return the code, and confirm the invitation appears in the invitations list as active.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/contacts` | List contacts |
| POST | `/contacts` | Create a contact |
| GET | `/contacts/{contact}` | Retrieve a contact |
| GET | `/contacts/{contact}/position` | Retrieve a contact's leaderboard standing |
| POST | `/invitations` | Mint an invitation |
| GET | `/broadcasts` | List broadcasts |
| POST | `/broadcasts/{broadcast}/send` | Send or schedule a broadcast |
| POST | `/segments` | Create a segment |

## Key resources

- **Contacts** — Add, update, and retrieve contacts plus their referrals, emails, and leaderboard position
- **Invitations** — Mint, redeem, confirm, and revoke invitations granting waitlist access
- **Broadcasts** — Draft, test, prepare, send, pause, and resume email broadcasts
- **Segments** — Build segments from filters and preview how many contacts match
- **Automations** — List automation sequences and the enrollments a contact belongs to

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 68 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 85 / 100
  - Developer Experience & Jentic Compatibility: 63 / 100
  - AI-Readiness & Agent Experience: 55 / 100
  - Agent Usability: 93 / 100
  - Security: 60 / 100
  - AI Discoverability: 66 / 100
- **View full report:** https://jentic.com/apis/getlaunchlist.com/getlaunchlist/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the LaunchList API by hand means handling its workspace bearer key, learning its handle-style ids and cursor pagination, and coding the contact and broadcast calls yourself. Through Jentic you install once, import the API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** LaunchList puts contact and broadcast ids in the URL path, so a rule can bound your agent to the operations it needs, such as adding contacts and reading positions. You choose which operations it may call, so sending a broadcast is not included unless you add it.
- **Credential handling:** Your LaunchList key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'add a contact to a waitlist' or 'send a broadcast', and Jentic returns the matching LaunchList operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **Mailchimp Marketing API** — Email marketing with audiences, campaigns, and automations
- **beehiiv API** — Newsletter publishing with subscriber referrals
- **MailerLite API** — Email campaigns, automations, and subscriber management

## FAQ

### Is there a LaunchList API MCP server?

You do not need an MCP server to give your agent the LaunchList API. Jentic connects it directly from the API Directory: import the API, store your key once, and your agent calls the contact, invitation, broadcast, and segment operations. Operations are discovered on demand, so no extra server definitions load into the agent's context.

### What authentication does the LaunchList API use?

The API authenticates with a bearer key per its OpenAPI spec, sent in the Authorization header, and the key belongs to the workspace rather than to the person who created it. Through Jentic the key is stored encrypted in your own Jentic One instance and supplied only when an allowed call runs, so it never reaches the agent's context.

### Can I send an email broadcast with the LaunchList API?

Yes. The broadcast operations let you create a draft, send a test to your team, prepare it, and then send or schedule it to a segment, with pause and resume available while it is going out. Each step is a separate operation so a workflow can stage the send before it reaches contacts.

### What are the rate limits for the LaunchList API?

The OpenAPI spec does not specify rate limits. Lists are cursor-paginated to keep large reads efficient, and you can confirm the current request limits in the LaunchList documentation at https://getlaunchlist.com/docs.

### Can I limit what my agent is allowed to do with the LaunchList API?

Yes. Write a rule that permits only the contact read and create operations when the agent should capture signups, and add the broadcast send operations only for workflows that actually email contacts, so a draft can never go out without your explicit choice, with every call logged.

### How do I add a contact to a waitlist with the LaunchList API through Jentic?

Search Jentic for 'add a contact to a waitlist' to surface the create-contact operation, load its input schema, pass the email and any referral code, and execute, then read the contact's position to show their standing. To run it on your own infrastructure, install Jentic One from its GitHub repo.