email_create_inbox
Create an inbox
A new email address for the business on its own subdomain, e.g. [email protected]. It can send and receive at once. With open_tickets=true it is a support inbox: every new email to it opens a help desk ticket (see ticket_connect_inbox). With save_attachments=true, attachments of mail it receives go to the file store (email-in, e.g. invoices@ for supplier bills). Rented at $1.00 a month, renewed from the balance; the first month is this call. Costs $1.00 per call; nothing if it fails.
输入参数local_part必填display_nameopen_ticketssave_attachments
email_update_inbox
Change an inbox
Change an inbox's sender name, switch email-in on or off (save_attachments saves each attachment of mail received from now on to the file store, linked to its email), or raise or lower what email-in saves in 24 hours (save_files_per_day, save_mb_per_day). $0.001. Costs $0.001 per call; nothing if it fails.
输入参数inbox必填display_namesave_mb_per_daysave_attachmentssave_files_per_day
email_list_inboxes
List inboxes
This account's inboxes, whether each opens help desk tickets or saves attachments to the file store, and when each renews. Free.
无需输入参数。
email_release_inbox
Release an inbox
Stop renting an inbox. Mail sent to it afterwards bounces; its stored messages stay readable. Free.
输入参数inbox必填
Send from one of this account's inboxes. Give reply_to_message_id to answer a received message in the same thread. attachments: up to 10 files of the file store, 25 MB together. Up to 20 recipients. For support, operations and replies, not cold outreach: at most 20 new addresses a day, never first to an address found with Conecto's lookups. An email to someone who never wrote first is checked before it goes: one that looks like cold outreach isn't sent, and the third within 7 days pauses the account's email. Unless by_person, a last line says the business's AI assistant wrote it. Big files are cheaper as a download link (files_get) in the text. Costs $0.001 per recipient, plus $0.001 per started MB of attachments for each recipient ($0.001 to one person without attachments; at most $0.52 a call); nothing if it fails.
输入参数ccto必填htmltext必填inbox必填subjectby_personattachmentsreply_to_message_id
email_save_attachments
Save an email's attachments
Save the attachments of one received email into the file store, each linked to the email, then read them like any file (files_read_text, documents_read_pdf, files_ocr). Ones saved before are kept, not saved again. Inline pictures (a signature's logo) and mail marked as spam are not saved. $0.001 per file saved; the original email is kept 30 days. Costs $0.001 per file saved; nothing if none are found.
输入参数message_id必填
email_list_messages
List messages
Messages in this account's inboxes, newest first: received, sent or both, optionally for one inbox, one sender or since a time. Free. Free.
输入参数frominboxlabellimitquerysincestatedirection
email_get_message
Read a message
One message in full: text, HTML and attachment names. Free. Free.
输入参数message_id必填
email_get_thread
Read a thread
Every message in the same conversation, oldest first. Free. Free.
输入参数message_id必填
email_update_thread
Mark where a thread stands
Mark an email thread open (needs a reply), waiting (on the other side), handled or archived, and set its labels, so you never reread or answer twice what you already dealt with: email_list_messages filters by state and label. A new message from outside opens a thread again. $0.001. Costs $0.001 per call; nothing if it fails.
输入参数statelabelsmessage_id必填
account_balance
Check balance
The account balance, how much of it is credit bought (AI visibility and the phone run only on that) and how much free and bonus credit, what running calls are holding, this key's daily budget, the auto-reload state, and how much of this month's free reads and downloads is used. Free.
无需输入参数。
account_get_call
Get a call
One call by id: its status (queued, running, succeeded, failed), cost and result. Use it to poll a background call until it finishes. Free.
输入参数call_id必填
account_list_calls
List calls
Recent calls on this account, newest first, optionally only failed or succeeded ones, or one area's. Free.
输入参数arealimitstatus
account_refund_topup
Refund a top-up
Refund a top-up paid in the last 24 hours that none of has been used yet: its credit, with the first top-up's bonus, leaves the balance, and the card gets the credit back with its tax. The service fee is kept. Without topup_id, the newest top-up (GET /v1/topups lists them with their ids). Free. Free.
输入参数topup_id
account_set_owner_email
Name the business's owner
When the account was made without the owner's email: send that person a link to confirm they own it. Once they confirm, the owner gets the account's warnings and approval requests, and only the owner raises limits. Nothing changes until they open the link. Free. Free.
输入参数email必填
account_owner_link
Get a sign-in link for the owner
A link that signs the business owner into their Conecto page, with no password: the balance, adding credit, auto-reload, limits, what the bots did, people, rentals and keys. page opens it where the owner is needed, like people for a role only the owner gives, or settings for joining by email domain. It works once, within 30 minutes; hand it to the owner. Free.
输入参数page
account_dashboard_link
Get a link to an area at a glance
A one-time link to a page showing one area as it is when the page opens, for when the person you work for asks to see it themselves: a recruiter looks at the applicants, a bookkeeper at what is due. Do the work and answer with the area's own tools first; a link never replaces that. When an answer would be a long list they would rather look through, offer a link and make it once they say yes. The page is made from the area's own reads as this key, so it shows only what this key may see. It opens once and keeps for an hour; an unopened link ends after 7 days. Free.
输入参数area必填
account_get_limits
Read the limits
The limits a business can ask Conecto to raise (calls a minute, new email addresses a day, phone numbers and more): each one's standard and current value and the most that can be asked for, and the business's requests with their answers. Free.
无需输入参数。
account_request_limit
Ask for a higher limit
Ask Conecto to raise one of the business's limits: which one (or other, saying which), the number it needs, and why, in 40 to 2,000 characters. Conecto reviews it and approves (maybe with less) or declines; the answer comes as the account.limit_request_answered event and by email to the owner, who is also told now. For an account that has topped up; one request per limit at a time, five in 30 days. Free. Free.
输入参数limit必填otheramount必填reason必填
account_events
Read recent events
What happened in this account that someone outside the bot did, oldest first: applications, bookings, form responses, signatures, replies, emails received, goals reached on the website; and the custom events bots sent with account_emit_event. Kept 30 days. Poll with after = the last event_id you saw. Free.
输入参数afterkindslimit
account_emit_event
Send an event of your own
Send an event you name, custom.<name> (custom.lead_qualified, custom.order_shipped), to every channel subscribed to it (notify_subscribe with "custom.*" or its name: Slack, Teams, a webhook to Zapier, Make, n8n or the business's own systems) and to account_events, where another team's bot can pick it up. data is any JSON object (up to 10 KB); sent_by is added with this bot's name and team. $0.005 for each channel it goes to; free when no channel is subscribed. Costs $0.005 per channel it goes to; nothing if none are found.
输入参数datakind必填linktexttitle必填
account_search
Search everything
One search over what this account holds: what its files say (PDFs, Word, Excel, PowerPoint, text), table rows, help center articles, CRM contacts, companies and deals, emails, tickets, quotes and invoices, book entries, stock items and project tasks. Every word must appear (any case); titles rank first, then the newest. Each result says which tool opens it. Narrow it with areas. Free.
输入参数areaslimitquery必填
account_get_brand
See the business's look
The name, logo, colour and footer line the business's emails and published pages carry. Free.
无需输入参数。
account_set_brand
Set the business's look
The business's name as the sender, its logo (a PNG, JPEG, WebP or GIF from the file store), its colour and a footer line (an address, a legal line), on every email to its customers (bookings, applications, tests, signatures, invoices, newsletters, replies) and on its published pages (forms, booking, careers, newsletters, status, views). Only what you pass changes; an empty string clears it. Mail from Conecto to you keeps Conecto's look. Costs $0.001 per call; nothing if it fails.
输入参数colourfooterremove_logosender_namelogo_file_id
account_list_email_templates
See what the business's emails say
Every email Conecto sends to the business's customers (bookings, applications, interviews, tests, signatures, invoices and quotes, newsletter sign-ups), with when it goes out and its subject, headline and opening words as they are now, and the {variables} each can use. Free.
无需输入参数。
account_set_email_template
Rewrite one of the business's emails
Change an email's subject, headline or opening words in the business's own voice, with {variables} from account_list_email_templates (like {name} or {when}). The facts under them (times, places, amounts, links and buttons) stay as they are. Only what you pass changes; an empty string brings back the original words. Plain text; a blank line starts a new paragraph. Costs $0.001 per call; nothing if it fails.
输入参数email必填openingsubjectheadline
account_export_all
Export everything
Everything this account holds, in ZIP files of up to 24 MB saved to its file store: every record of every area as JSON Lines, and the stored files themselves, with a README saying what is where. Credentials are left out. Runs in the background: poll the call with account_get_call; the result has a download link for each part. The parts open only for this key and for the owner's and admins' own keys that neither only read nor only draft. A key of a team other than the company-wide one gets owner_required. Free (EU Data Act). One at a time, three a day; the owner is emailed when an export is made. Free. Runs in the background: the reply has a call_id; poll it with the account_get_call tool or GET /v1/calls/<id>.
无需输入参数。
account_audit_log
Read the audit log
The account's admin and security actions, newest first: keys made and revoked, limits and auto-reload, the owner's sign-ins, connectors, exports, vault reads and writes, credentials set and everything deleted. Ordinary work is in the call log (account_list_calls). verify: true also checks the hash chain, which breaks where an entry was changed or removed. Free.
输入参数limitsinceactionverify
account_save_team
Create or change a team
A department, location or project group of the account, like Support, Finance or the Hamburg shop. Its keys (POST /v1/keys with "team") can only work in its areas, only read when read_only is on, and spend against its budget (monthly_budget_usd per budget_period: a month, a fiscal quarter or year, or a project total): a hard budget refuses the call that would pass it, a soft one only warns. At alert_percent you get the event account.budget_alert and the owner an email, once a period. erp_code is the team's cost center in the company's ERP, for statements. drafts_only makes every write of its keys wait for one of its managers (or the owner), for a new bot that should only draft. mailboxes are the Microsoft 365 or Google mailboxes its keys may act as. You may make a team and narrow one; widening its areas, letting it write, ending drafts only, switching a hard budget to soft, and raising or removing a budget are the owner's, on their account page, when the account has an owner email. The company-wide team holds every key no other team does and is never limited to areas. $0.001. Costs $0.001 per call; nothing if it fails.
输入参数name必填areasbudgeterp_codenew_namemailboxesread_onlydrafts_onlyalert_percentbudget_periodbudget_ends_onsees_sensitive另有 1 个
account_list_teams
List teams
The account's teams, the company-wide one first: each with its areas, whether it only reads, its budget (hard or soft, and its period) and alert line, this period's spend, its ERP code, whether it is paused, its keys, and its people with who manages it. A person's own assistant works within their teams. Free.
无需输入参数。
account_pause_team
Pause a team
Stops every key of a team at once, this one too if it is the team's: their calls are refused until the owner starts the team again on their account page. For a bot that misbehaves or a team that spends too fast. Free. Free.
输入参数team必填
account_assign_team
Give something to a team
Move a form, a meeting type, a job, an inbox, a phone number, a newsletter, the website chat, a rental, a pipeline, a table or a website to a team. What happens through it is charged to that team from now on (a form's responses, a number's calls, an inbox's tickets), and its rental moves with it. Something a bot makes already belongs to the bot's team. Only a key of the company-wide team without limits moves things between teams. $0.001. Costs $0.001 per call; nothing if it fails.
输入参数idkind必填team必填
account_add_approval_rule
Hold a tool for approval
Make a tool wait for a person: every call of it, those whose argument is over a number (like invoices_create_credit_note when amount is over 500), or those whose argument is one of some values (like connect_call when method is POST, PUT, PATCH or DELETE). A held call answers approval_required with an approval_id and asks the approver; when they approve, call again with the same arguments, once (a call no person answers for adds the approval: header X-Conecto-Approval, or _meta.approvalId over MCP). The approver is an email, a saved channel, or a team (its managers, or everyone in it); each approver gets a link of their own, and the person whose call it is never approves it. With two_people_over, calls whose argument is over it need two people. Bills like Xero's bill approval: purchasing_create_bill with argument total holds bills over an amount, tax included; a rule on purchasing_pay_bill also holds batches with such a payment. Removing a rule is the owner's, on their account page, when the account has an owner email. $0.001. Costs $0.001 per call; nothing if it fails.
输入参数overtool必填valuesargumentapproversapprover_teamapprover_emailtwo_people_overapprover_channel
account_list_approval_rules
List approval rules
The tools that wait for a person's approval, with their thresholds and approvers. Free.
无需输入参数。
account_find_person
Find a person's data
Every record this account holds about one person, by their email address or phone number, across every area: CRM, chats, emails, tickets, forms, bookings, calls, applications, invoices, orders, newsletters, HR and the call log, with their chats and CRM history. For a person who asks what the business keeps about them (GDPR Art. 15). Shows each kind with its count and ids; account_export_person gives them a copy, account_erase_person erases what may go. Free.
输入参数emailphone
account_export_person
Export a person's data
Everything account_find_person finds about one person in one ZIP in the file store: their records as JSON Lines (credentials left out) and the files those records point to, like a CV. Give the person the download link when they ask for a copy of their data (GDPR Art. 15 and 20), once you know it is them. The ZIP opens only for this key and for the owner's and admins' own keys that neither only read nor only draft. A key of a team other than the company-wide one gets owner_required: pass the request to the owner. Free; 20 a day. Free.
输入参数emailphone
account_erase_person
Erase a person's data
Erases one person across every area when they ask (GDPR Art. 17), once you know it is them (they wrote from that address, or confirmed it). Their CRM contact, chat visitor, past meetings and calls are anonymised, so deals stay without them, and a meeting they were only a guest at drops them; their chats, CRM history, form and routing form answers, job applications with the CV, newsletter subscriptions and events are deleted, and the call log's contents that name them are cleared. Kept, each with its reason in the result: accounting records, employment records, signed documents, the audit log, the account's own settings, upcoming meetings, and emails and tickets (outreach emails and replies too) unless correspondence is true. Their address goes on the suppression lists, so it is never mailed again: outreach campaigns stop for them at once. Can't be undone; the owner is emailed. A key of a team other than the company-wide one gets owner_required: pass the request to the owner. Free. Free.
输入参数emailphonecorrespondence
account_data_locations
See where the data is
Where each area's data is stored and processed: the company that runs each place, the country or region, and what it holds. Every area keeps its records in the database and runs on Conecto's servers; some also use a service named here (email, phone, PDFs, search). For the business's records of processing and its transfer assessments (GDPR Art. 30 and 44). Free.
输入参数areas