canonical: https://jentic.com/apis/raklet.com/raklet # Raklet API The Raklet API manages the member and contact records of associations, nonprofits, clubs, chambers, and alumni organizations on Raklet's membership platform. It creates and updates contacts with their addresses, emails, phones, education, and work history, groups members with tags, and records membership payments, debts, donations, and subscriptions against an organisation. It also lists events and ticket options, posts to boards and news feeds, and reads directory data such as corporate members, job postings, and organisation settings, with most routes scoped by organisationId. ## For AI agents Create and update Raklet member contacts, tag members, record payments and donations, and read events, posts, and directory data for a membership organisation. ## Scope Does not handle email campaign delivery, accounting ledgers, or public event marketplaces. Use for Raklet membership contacts, tags, dues, donations, events, and community posts only. ## Capabilities - Search an organisation's contacts with a base64-encoded q filter and page through them with pageSize and offset - Create a contact with firstName, lastName, and language, then add addresses, emails, phones, and work history - Add or remove members from a tag in one call using a list of organisationMembershipIds - Record membership payments with amount, currency, and paymentMethod, and log debts and donations per member - List an organisation's events and ticket options and create a ticket for a member - Publish news posts and board posts to the organisation's community feed ## Use cases ### Membership admin agent through Jentic An AI agent can take routine membership admin off a small association's volunteers. Through Jentic the agent searches for 'add a member to a membership organisation', receives the Contact_Post operation with its input schema, and creates the contact under the organisation, with the bearer token from Raklet's password grant injected at execution time. It can then tag the new member and record their first membership payment. Example prompt: Create a contact with POST `/organisations/{organisationId}/contacts` using firstName 'Aoife', lastName 'Byrne', and language 'en', then add them to a tag with POST `/admin/organisations/{organisationId}/tags/{id}/AddMembers` ### Dues and donation reconciliation Treasurers of clubs and associations need membership dues and donations recorded against the right person. Raklet records payments through POST `/organisations/{organisationId}/payments`, which requires amount, currency, and paymentMethod and accepts an organisationMembershipId and isRecurringPayment, while donations link to a donationCampaignId and debts track what a member still owes. Example prompt: List debts with GET `/organisations/{organisationId}/debts`, then record a matching payment with POST `/organisations/{organisationId}/payments` using amount 50, currency 'EUR', and paymentMethod for the member's organisationMembershipId ### Member segmentation with tags Associations send targeted communications to committees, volunteers, or event attendees. Raklet tags are created per organisation and updated in bulk with AddMembers and RemoveMembers, which take a list of organisationMembershipIds, and GET `/admin/organisations/{organisationId}/tags/{id}/members` pages through who carries a tag. Example prompt: Create a tag 'Volunteers 2026' with POST `/admin/organisations/{organisationId}/tags` and add three members to it with the AddMembers operation ### Community news and events Membership organisations keep members engaged with news and events. Raklet publishes posts with POST `/organisations/{organisationId}/posts`, posts to discussion boards, and lists events with their ticket options through the app routes, so an agent can draft a weekly digest of upcoming events and recent news. Example prompt: Call GET `/app/organisations/{organisationId}/events` and GET `/organisations/{organisationId}/posts`, then draft a digest of upcoming events and recent posts ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/token` | Get an access token | | GET | `/organisations/{organisationId}/contacts` | Search contacts | | POST | `/organisations/{organisationId}/contacts` | Create a contact | | POST | `/admin/organisations/{organisationId}/tags/{id}/AddMembers` | Add members to a tag | | POST | `/organisations/{organisationId}/payments` | Record a payment | | GET | `/organisations/{organisationId}/donations` | List donations | | GET | `/app/organisations/{organisationId}/events` | List events | | GET | `/public/account/me` | Get the current account | ## Key resources - **Contacts** — Member and contact records with addresses, emails, phones, education, work history, and photos - **Tags** — Organisation tags with bulk add and remove of members - **Payments, debts, and donations** — Membership payments, outstanding debts, donations, and donation campaigns - **Subscriptions and plans** — Membership plans and member subscriptions - **Events** — Events, ticket options, tickets, and member event submissions - **Posts and boards** — News posts with attachments and discussion boards - **Directory data** — Corporate members, companies, schools, sectors, job postings, and job seekers ## 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:** 38 / 100 - **Maturity:** Non-Ready - **Dimensions:** - Foundational Compliance: 74 / 100 - Developer Experience & Jentic Compatibility: 63 / 100 - AI-Readiness & Agent Experience: 17 / 100 - Agent Usability: 71 / 100 - Security: 45 / 100 - AI Discoverability: 56 / 100 - **View full report:** https://jentic.com/apis/raklet.com/raklet/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 ``` ## Why Jentic - **Setup:** Wiring Raklet by hand means running the OAuth 2.0 password grant against POST /token with an admin's email and password, refreshing the bearer token roughly hourly, and threading organisationId through nearly every path. Through Jentic you install once, import Raklet from the API Directory, store the credential once, and your agent calls it. - **Permission scoping:** A Raklet token carries the admin user's full permissions with no narrower scopes, but Raklet puts the organisation id in the URL path (`/organisations/{organisationId}/...`), so a rule can pin your agent to one organisation and the operations you pick. You choose what it may call, so destructive ones like contact deletion or payment deletion are not included unless you add them. - **Credential handling:** Your Raklet credential 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 member to a membership organisation' or 'record a membership payment', and Jentic returns the matching Raklet operation with its input schema so the agent calls the right endpoint without browsing the reference. ## Related APIs - **CiviCRM** — Open-source CRM for nonprofits with contacts, contributions, events, and memberships - **Bloomerang** — Nonprofit donor CRM with transactions, pledges, and campaigns - **Eventbrite** — Public event listing, ticketing, and attendee management ## FAQ ### What authentication does the Raklet API use? Per its OpenAPI spec, the Raklet API uses a bearer access token obtained from POST /token with the OAuth 2.0 password grant, using a Raklet admin user's email and password. Every other operation expects the token in the Authorization header. Raklet defines no narrower scopes, so a token carries the full permissions of the admin user it was issued to, and it expires after about an hour. ### How do I find my organisationId for the Raklet API? Most Raklet paths take an organisationId. Find it in the Raklet admin panel under Settings, or call GET `/public/account/me` with your access token. ### What are the rate limits for the Raklet API? The OpenAPI spec does not specify rate limits. Check the Raklet developer portal at https://www.raklet.com/developers/ for current limits. API access is included in Raklet's Premium plan. ### Is there a Raklet MCP server? You don't need an MCP server to give your agent Raklet. Jentic connects it directly from the API Directory: import it, store your admin credential once, and your agent calls the contact, tag, and payment operations it needs, discovered on demand. ### Can I limit what my agent is allowed to do with the Raklet API? Yes, and it matters here because a Raklet token has no scopes. For example, write a rule that allows only the contact search, contact details, and tag-membership operations under your organisationId, so the agent can find and tag members but cannot delete contacts or record payments. Every call it makes is logged. ### How do I add a member to Raklet through Jentic? Search Jentic for 'add a member to a membership organisation', load the POST `/organisations/{organisationId}/contacts` operation, and execute it with firstName, lastName, and language. To run it on your own infrastructure, install Jentic One from its GitHub repo.