Lelemon
  • Get started
  • Use cases
  • Guides
  • API basics
  • Webhooks
  • SDK, CLI and MCP
  • API reference
  • Changelog
  • v1 (legacy)
Information
Me
    Retrieve the current keyget
API keys
    List scopesget
Agents
    List agentsgetCreate an agentpostRetrieve an agentgetDelete an agentdeleteUpdate an agentpatchActivate an agentpostPause an agentpostList versionsgetRetrieve a versiongetRestore a versionpostList the fixed facts of an agentgetSave a fixed fact of an agentputForget a fixed fact of an agentdelete
Models and templates
    List agent templatesgetList modelsget
Subaccounts
    List subaccountsgetCreate a subaccountpostRetrieve a subaccountgetDelete a subaccountdeleteUpdate a subaccountpatchGive a subaccount its own keypost
WhatsApp
    List WhatsApp connectionsgetCreate a WhatsApp connection linkpostRetrieve a WhatsApp connectiongetRevoke a pending WhatsApp connectiondeleteList WhatsApp phone numbersgetRetrieve a WhatsApp phone numbergetDisconnect a WhatsApp phone numberdeleteChange the agent, label or state of a numberpatchRead the cart and catalog settings of a numbergetTurn the cart button or the catalog icon of a number on or offpatch
Actions
    List actionsgetCreate an actionpostRead the current authorization textgetRotate the signing secret of your actionspostRetrieve the signing secret of an actiongetRetrieve an actiongetDelete an actiondeleteUpdate an actionpatchTest an actionpostRead the approval floor of a shared actiongetSet the approval floor of a shared actionput
MCP servers
    List MCP serversgetConnect an MCP serverpostRetrieve an MCP servergetDisconnect an MCP serverdeleteUpdate an MCP serverpatchList the tools of an MCP servergetDiscover toolspostRead the run identity of an MCP servergetTurn on or rotate the run identity of an MCP serverpostTurn off the run identity of an MCP serverdelete
Data connectors
    Get the lelemon-connector/v1 formatgetValidate a connector documentpostList data connectorsgetRegister a data connectorpostRetrieve a data connectorgetDelete a data connectordeleteUpdate a data connectorpatchRetrieve the signing secret of a data connectorgetRotate the signing secret of a data connectorpostCheck a data connectorpostRetrieve the manifest of a data connectorgetSearch accounts by emailgetRead the card of an account livegetReveal one masked value of an accountpostGet the link of an account actionpostRead a view livegetList who looked at what through a connectorget
Skills
    List skillsgetCreate a skillpostRetrieve a skillgetDelete a skilldeleteUpdate a skillpatch
Agent tools
    List an agent's toolsgetGrant a toolputRemove a tooldelete
Approvals
    List approvalsgetRetrieve an approvalgetApprove an actionpostReject an actionpostAsk for a human review of a decisionpost
Automated decisions
    List automated decisionsgetRetrieve an automated decisiongetAsk for a human review of an automated decisionpost
Team questions
    List team questionsgetRetrieve a team questiongetRead a team question with its contextgetAnswer a team questionpost
Runs
    Give an agent a jobpostList runsgetRetrieve a rungetCancel a runpostAnswer a run that asked somethingpost
Schedules
    Schedule a job for an agentpostList scheduled tasksgetRetrieve a scheduled taskgetDelete a scheduled taskdeleteChange a scheduled taskpatchFire a scheduled task nowpost
Pipelines
    List pipelinesgetCreate a pipelinepostRetrieve a pipelinegetDelete a pipelinedeleteUpdate a pipelinepatchClone a pipelinepostReorder the stages of a pipelinepost
Stages
    List the stages of a pipelinegetCreate a stagepostRetrieve a stagegetDelete a stagedeleteUpdate a stagepatchMake a stage the entry stagepost
Fields
    List the fields of a pipelinegetCreate a fieldpostRetrieve a fieldgetDelete a fielddeleteUpdate a fieldpatch
Routing rules
    List the routing rules of a pipelinegetCreate a routing rulepostRetrieve a routing rulegetDelete a routing ruledeleteUpdate a routing rulepatch
Knowledge
    List collectionsgetCreate a collectionpostSearch the knowledgepostRetrieve a collectiongetDelete a collectiondeleteUpdate a collectionpatchList documentsgetAdd a documentpostRetrieve a documentgetDelete a documentdeleteUpdate a documentpatchLet an agent search a collectionputStop an agent from searching a collectiondelete
Contacts
    List contactsgetCreate a contactpostCreate or update a contact by your own idputRetrieve a contactgetErase a contactdeleteUpdate a contactpatch
Contact fields
    List the contact fieldsgetCreate a contact fieldpostRetrieve a contact fieldgetDelete a contact fielddeleteUpdate a contact fieldpatch
Companies
    List companiesgetCreate a companypostRetrieve a companygetDelete a companydeleteUpdate a companypatch
Lead forms
    List lead formsgetCreate a lead formpostRetrieve a lead formgetDelete a lead formdeleteUpdate a lead formpatch
Suppressions
    Retrieve a suppressionget
Cases
    List casesgetOpen a casepostRetrieve a casegetDelete a casedeleteUpdate a casepatchMove a case to a stagepostAssign a case to a memberpostClose a casepostReopen a casepostTake control of a casepostHand a case back to the agentpostMark a case as readpostMove several cases to a stagepostArchive a casepostBring an archived case backpostMute the contact of a casepostUnmute the contact of a casepostHand a case to a personpostReveal a sensitive field of a casepostEscalate a case to the technical teampostList the escalations of a caseget
Case queue
    Read the attention queue of a memberget
Contact events
    List the events of a contactgetReport a contact eventpostRetrieve a contact eventget
Case reminders
    List the reminders of a casegetAdd a reminder to a casepost
Reminders
    Retrieve a remindergetDelete a reminderdeleteEdit a reminderpatchComplete a reminderpostDismiss a reminderpost
Presence
    Report who is online in your apppostRead the presence settinggetTurn presence on or offput
Organization
    Get the organizationgetRename the organizationpatchGet the organization settingsgetChange the organization settingspatchGet the company profilegetChange the company profilepatch
Case notes
    List the notes of a casegetAdd a note to a casepostRetrieve a notegetDelete a notedeleteEdit a notepatch
Case attachments
    List the files of a casegetUpload a file to a casepostRetrieve a file of a casegetDelete a file of a casedeleteGet the download link of a fileget
Files
    List filesgetUpload a filepostRetrieve a filegetDelete a filedelete
Case messages
    List the messages of a casegetAdd a message to a casepostRedact a messagepost
Case turns
    List the turns the agent took in a caseget
Usage
    Get the usage of your agentsget
Case metrics
    List the times of the cases that changed in a rangeget
Budgets
    List the budgetsgetCreate a monthly budgetpostGet a budgetgetDelete a budgetdeleteChange a budgetpatch
Members
    List the active members of the organizationgetList who invited, changed the role of or removed membersgetRead whether a team member is availablegetMark a team member available or awayputChange the role of a memberpatchChange which cases a member seespatchRemove a member from the organizationdelete
Invitations
    List the invitations of the organizationgetInvite a person to the organizationpostResend an invitationpostCancel an invitationpost
Scheduling
    List the agendasgetCreate an agendapostRetrieve an agendagetUpdate an agendapatchList the team of an agendagetAdd a person to the team of an agendapostRemove a person from the team of an agendadeleteUpdate a person in the team of an agendapatchRead the free slots of an agendagetList meetingsgetBook a meetingpostRetrieve a meetinggetCancel a meetingpostMove a meeting to another slotpost
Webhook endpoints
    List webhook endpointsgetCreate a webhook endpointpostRetrieve a webhook endpointgetDelete a webhook endpointdeleteUpdate a webhook endpointpatchRotate the signing secretpostSend a test eventpostList the deliveries of an endpointget
Events
    Resend an eventpostList the event typesget
Recipient allowlist
    Get the recipient allowlistgetReplace the recipient allowlistput
WhatsApp templates
    List templatesgetCreate a templatepostSync template statusespostRetrieve a templategetDelete a templatedeleteUpdate a templatepatchRender a templatepostSend a test messagepost
WhatsApp messages
    Send a templatepostRetrieve a template messagegetCancel a scheduled messagepost
Triggers
    List triggersgetCreate a triggerpostRetrieve a triggergetDelete a triggerdeleteUpdate a triggerpatchList the runs of a triggerget
Opt-outs
    List opt-outsgetOpt a contact outputClear an opt-outdelete
Campaigns
    List campaignsgetCreate a campaignpostRetrieve a campaigngetDelete a campaigndeleteUpdate a campaignpatchPreview a campaignpostLaunch a campaignpostPause a campaignpostResume a campaignpostCancel a campaignpostList recipientsget
Email domains
    List the sender domainsgetAdd a sender domainpostGet a sender domain with its status and DNS recordsgetRemove a sender domaindeleteChange the default sender or the inbound agent of a domainpatchCheck the DNS records nowpost
Email messages
    Write first by emailpostRetrieve an email messageget
Teams
    List the teamsgetCreate a teampostRetrieve a teamgetDelete a teamdeleteUpdate a teampatchMerge another team into this onepostMove a pipeline into a teamputAdd a member to a team or change their role in itputRemove a member from a teamdelete
Linear
    Get the Linear connectiongetConnect LinearputDisconnect LineardeleteUpdate the Linear connectionpatch
Schemas
powered by Zudoku
Lelemon API
Lelemon API

Organization


Get the organization

GET
https://api.lelemon.cl
/v2/organization
Bearer (API key)

The name and slug of the organization or subaccount the key acts on.

Required scope: organization:read.

Get the organization › Headers

Lelemon-Subaccount
​string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Get the organization › Responses

Organization
object
​string · enum · required
Enum values:
organization
id
​string · required
name
​string · required
slug
​string · required
GET/v2/organization
curl https://api.lelemon.cl/v2/organization \ --header 'Authorization: Bearer <token>'
Example Responses
{ "object": "organization", "id": "org_4Zq0x8bVw1TqS9mYp3RkLd", "name": "Panadería Ana", "slug": "panaderia-ana" }
json
application/json

Rename the organization

PATCH
https://api.lelemon.cl
/v2/organization
Bearer (API key)

Changes the name, with the same rule as the panel. Only a key issued by the owner can use it. Idempotent: the same body leaves the same name.

Required scope: organization:write.

Rename the organization › Headers

Lelemon-Subaccount
​string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Rename the organization › Request Body optional

UpdateBasicInfo

Rename the organization › Responses

Organization
object
​string · enum · required
Enum values:
organization
id
​string · required
name
​string · required
slug
​string · required
PATCH/v2/organization
curl https://api.lelemon.cl/v2/organization \ --request PATCH \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <token>' \ --data '{ "name": "Panadería Ana" }'
Example Request Body
{ "name": "Panadería Ana" }
json
application/json
Example Responses
{ "object": "organization", "id": "org_4Zq0x8bVw1TqS9mYp3RkLd", "name": "Panadería Ana", "slug": "panaderia-ana" }
json
application/json

Get the organization settings

GET
https://api.lelemon.cl
/v2/organization/settings
Bearer (API key)

Business hours, inactivity closing, presence, trace storage and branding of the organization or subaccount the key acts on.

Required scope: organization:read.

Get the organization settings › Headers

Lelemon-Subaccount
​string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Get the organization settings › Responses

OrganizationSettings
object
​string · enum · required
Enum values:
organization_settings
​required

When the human team attends. Null until it is set. An agent in a stage set to answer outside business hours answers only outside this window.

cerrarTrasDiasSinActividad
​number | null · required

Days of silence after which a conversation closes by itself. Null means it never closes by inactivity. Until it is set, the house default applies.

presenceEnabled
​boolean · required

Whether presence shows. Same setting as /v2/presence/settings.

noPersistTraces
​boolean · required

While true, the traces of the agent turns are not stored.

​object | null · required

Public branding of the organization: logo, color and links.

GET/v2/organization/settings
curl https://api.lelemon.cl/v2/organization/settings \ --header 'Authorization: Bearer <token>'
Example Responses
{ "object": "organization_settings", "businessHours": { "timezone": "America/Santiago", "startHour": 9, "endHour": 18, "activeSaturday": true, "activeSunday": true }, "cerrarTrasDiasSinActividad": 0, "presenceEnabled": true, "noPersistTraces": true, "branding": {} }
json
application/json

Change the organization settings

PATCH
https://api.lelemon.cl
/v2/organization/settings
Bearer (API key)

Merges the fields you send into the settings, with the same validation as the panel: business hours need a timezone, start and end hour from 0 to 23, and Saturday and Sunday flags. Send cerrarTrasDiasSinActividad null to turn the inactivity closing off. Idempotent: the same body leaves the same settings.

Required scope: settings:write.

Change the organization settings › Headers

Lelemon-Subaccount
​string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Change the organization settings › Request Body optional

UpdateSettings

Change the organization settings › Responses

OrganizationSettings
object
​string · enum · required
Enum values:
organization_settings
​required

When the human team attends. Null until it is set. An agent in a stage set to answer outside business hours answers only outside this window.

cerrarTrasDiasSinActividad
​number | null · required

Days of silence after which a conversation closes by itself. Null means it never closes by inactivity. Until it is set, the house default applies.

presenceEnabled
​boolean · required

Whether presence shows. Same setting as /v2/presence/settings.

noPersistTraces
​boolean · required

While true, the traces of the agent turns are not stored.

​object | null · required

Public branding of the organization: logo, color and links.

PATCH/v2/organization/settings
curl https://api.lelemon.cl/v2/organization/settings \ --request PATCH \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <token>' \ --data '{ "businessHours": { "timezone": "America/Santiago", "startHour": 9, "endHour": 18, "activeSaturday": false, "activeSunday": false }, "cerrarTrasDiasSinActividad": 30 }'
Example Request Body
{ "businessHours": { "timezone": "America/Santiago", "startHour": 9, "endHour": 18, "activeSaturday": false, "activeSunday": false }, "cerrarTrasDiasSinActividad": 30 }
json
application/json
Example Responses
{ "object": "organization_settings", "businessHours": { "timezone": "America/Santiago", "startHour": 9, "endHour": 18, "activeSaturday": true, "activeSunday": true }, "cerrarTrasDiasSinActividad": 0, "presenceEnabled": true, "noPersistTraces": true, "branding": {} }
json
application/json

Get the company profile

GET
https://api.lelemon.cl
/v2/organization/company-profile
Bearer (API key)

What the agents know about the business: name, description, contact, schedule, services, FAQ and custom instructions.

Required scope: organization:read.

Get the company profile › Headers

Lelemon-Subaccount
​string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Get the company profile › Responses

CompanyProfile
object
​string · enum · required
Enum values:
company_profile
businessName
​string
businessDescription
​string
address
​string
phone
​string
email
​string
website
​string
schedule
​string
​object[]
​object[]
customInstructions
​string
GET/v2/organization/company-profile
curl https://api.lelemon.cl/v2/organization/company-profile \ --header 'Authorization: Bearer <token>'
Example Responses
{ "object": "company_profile", "businessName": "businessName", "businessDescription": "businessDescription", "address": "address", "phone": "phone", "email": "email", "website": "website", "schedule": "schedule", "services": [ { "name": "name", "description": "description" } ], "faq": [ { "question": "question", "answer": "answer" } ], "customInstructions": "customInstructions" }
json
application/json

Change the company profile

PATCH
https://api.lelemon.cl
/v2/organization/company-profile
Bearer (API key)

Merges the fields you send into the profile; services and faq are replaced whole. Same validation as the panel. Idempotent: the same body leaves the same profile.

Required scope: settings:write.

Change the company profile › Headers

Lelemon-Subaccount
​string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Change the company profile › Request Body optional

UpdateCompanyProfile

Change the company profile › Responses

CompanyProfile
object
​string · enum · required
Enum values:
company_profile
businessName
​string
businessDescription
​string
address
​string
phone
​string
email
​string
website
​string
schedule
​string
​object[]
​object[]
customInstructions
​string
PATCH/v2/organization/company-profile
curl https://api.lelemon.cl/v2/organization/company-profile \ --request PATCH \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <token>' \ --data '{ "businessName": "Panadería Ana", "schedule": "Lunes a viernes, 9 a 18", "services": [ { "name": "Pan de masa madre", "description": "Horneado cada día." } ] }'
Example Request Body
{ "businessName": "Panadería Ana", "schedule": "Lunes a viernes, 9 a 18", "services": [ { "name": "Pan de masa madre", "description": "Horneado cada día." } ] }
json
application/json
Example Responses
{ "object": "company_profile", "businessName": "businessName", "businessDescription": "businessDescription", "address": "address", "phone": "phone", "email": "email", "website": "website", "schedule": "schedule", "services": [ { "name": "name", "description": "description" } ], "faq": [ { "question": "question", "answer": "answer" } ], "customInstructions": "customInstructions" }
json
application/json

PresenceCase notes