Endpoint
Every tool is a thin wrapper over the v1 REST API using your own key, so scopes, rate limits and
tenant isolation behave exactly as they do for a direct HTTP call.
Access requirements
1
A LumisReach account
Sign in at app.lumisreach.com. Your workspace is what the agent acts inside
— calls, contacts and transcripts land there.
2
An API key
Settings → Developer API (app.lumisreach.com/settings/api).
The key is shown once; store it somewhere safe. A key created this way is unrestricted and works on every
tool below.
3
A payment method for paid actions
Reading data is free. Placing calls, sending texts and buying numbers draw on your wallet, so add a card
under Settings → Billing first. See pricing.
Nothing else is required to use the shared senders: quick calls and quick texts go out from LumisReach-owned
numbers, so an agent can make its first call minutes after the key is created.
Connect a client
Tools
Quick Agent Actions
These need no phone number of your own — they run from shared LumisReach senders. This is what an agent should reach for by default.Lincoln AI
Hand a whole task to your workspace’s own AI agent instead of calling tools one by one. Lincoln plans the work, runs the tools itself and asks before anything that costs money. See Lincoln AI.Calls, texts and contacts
Free reads of what your workspace has said and heard.list_calls and list_messages cover the whole account,
newest first, or one person when given a contact_id or phone_number, and filter by direction and time.
Billing
Free reads of your plan, wallet and what each kind of usage cost.Number configuration
Read and change everything on a number’s Answer page: voice, prompt, greeting, SMS auto-reply agent, knowledge, qualifying questions, booking, transfer number and rules, call forwarding and the keypad phone menu. See Number configuration. Free.Primitives
For callers that already own a number and want to drive it directly.Example
“Call +1 415 555 0123 and find out whether they still want the quote. Try twice if nobody answers.”The agent calls
start_ai_phone_call with the goal and retry_attempts: 1, gets back a job id, and
polls get_quick_action_status until the target reports completed with a summary of what was said.