Booking, CRM, contracts, invoicing, payments and outreach for entertainers & small businesses.
Maintained by@semcycle(verified)Also a maintainer?
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add a document/media item to the locker. category = w9|photo|rider|stage_plot|tech_spec|bio|press_kit|logo|setlist|ach|other; optional title and notes. Provide EITHER file_base64 (a PDF/JPG/PNG/GIF/WebP, up to 25 MB) + file_name, OR link_url (for a big gallery / EPK).
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http actbook https://actbook.app/api/mcp
Showing the first 150 of 258, by name. Connect in the playground above to browse them all.
Add a document/media item to the locker. category = w9|photo|rider|stage_plot|tech_spec|bio|press_kit|logo|setlist|ach|other; optional title and notes. Provide EITHER file_base64 (a PDF/JPG/PNG/GIF/WebP, up to 25 MB) + file_name, OR link_url (for a big gallery / EPK).
| Argument | Type | Description |
|---|---|---|
| notes | string | |
| title | string | |
| category* | string | |
| link_url | string | |
| file_name | string | |
| file_base64 | string |
{
"type": "object",
"required": [
"category"
],
"properties": {
"notes": {
"type": "string"
},
"title": {
"type": "string"
},
"category": {
"type": "string"
},
"link_url": {
"type": "string"
},
"file_name": {
"type": "string"
},
"file_base64": {
"type": "string"
}
}
}Block a date range from online booking (end_date defaults to start_date).
| Argument | Type | Description |
|---|---|---|
| note | string | |
| end_date | string | |
| start_date* | string |
{
"type": "object",
"required": [
"start_date"
],
"properties": {
"note": {
"type": "string"
},
"end_date": {
"type": "string"
},
"start_date": {
"type": "string"
}
}
}Upload an image for a broadcast email and get back a permanent public URL to embed in the body_html (<img src="...">). image_base64 = the image bytes base64-encoded (or a data: URI); mime = image/jpeg|png|gif|webp (auto-detected if omitted). Max 6 MB.
| Argument | Type | Description |
|---|---|---|
| mime | string | |
| image_base64* | string |
{
"type": "object",
"required": [
"image_base64"
],
"properties": {
"mime": {
"type": "string"
},
"image_base64": {
"type": "string"
}
}
}Add a note to a client's record — it shows in the client's notes/history on the client page, dated and attributed. Use it to log calls, emails/inquiry replies, what was quoted or agreed, follow-ups. id = the client id. Optional booking_id ties it to one of their bookings too.
| Argument | Type | Description |
|---|---|---|
| id* | integer | |
| sticky | boolean | |
| comment* | string | |
| booking_id | integer |
{
"type": "object",
"required": [
"id",
"comment"
],
"properties": {
"id": {
"type": "integer"
},
"sticky": {
"type": "boolean"
},
"comment": {
"type": "string"
},
"booking_id": {
"type": "integer"
}
}
}Add a note to a CLIENT's history (shows on the client page) or to a booking — e.g. log a call, an inquiry reply, or what was agreed. Pass client_id (and/or booking_id) and comment. Use this (or add_client_note) to put a note on a client — add_project_note is a shared notepad not tied to any client.
| Argument | Type | Description |
|---|---|---|
| sticky | boolean | |
| comment* | string | |
| client_id | integer | |
| booking_id | integer |
{
"type": "object",
"required": [
"comment"
],
"properties": {
"sticky": {
"type": "boolean"
},
"comment": {
"type": "string"
},
"client_id": {
"type": "integer"
},
"booking_id": {
"type": "integer"
}
}
}Add a contact (name/email/phone) to a client.
| Argument | Type | Description |
|---|---|---|
| id* | integer | |
| name | string | |
| string | ||
| phone | string |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
}
}
}Add a gig date to a booking. date=YYYY-MM-DD required. Optional: type (event-type id), setup_time/start_time/end_time/done_time (HH:MM), participants, volunteers, venue, address, city, state, zip, phone, timezone, is_public, segment_price, act_id (this date's act — only with 'Book multiple acts per booking' on; else the booking's act).
| Argument | Type | Description |
|---|---|---|
| id* | integer | |
| zip | string | |
| city | string | |
| date* | string | |
| type | integer | |
| phone | string | |
| state | string | |
| venue | string | |
| act_id | integer | |
| address | string | |
| end_time | string | |
| timezone | string | |
| done_time | string | |
| is_public | boolean | |
| setup_time | string | |
| start_time | string | |
| volunteers | integer | |
| participants | integer | |
| segment_price | number |
{
"type": "object",
"required": [
"id",
"date"
],
"properties": {
"id": {
"type": "integer"
},
"zip": {
"type": "string"
},
"city": {
"type": "string"
},
"date": {
"type": "string"
},
"type": {
"type": "integer"
},
"phone": {
"type": "string"
},
"state": {
"type": "string"
},
"venue": {
"type": "string"
},
"act_id": {
"type": "integer"
},
"address": {
"type": "string"
},
"end_time": {
"type": "string"
},
"timezone": {
"type": "string"
},
"done_time": {
"type": "string"
},
"is_public": {
"type": "boolean"
},
"setup_time": {
"type": "string"
},
"start_time": {
"type": "string"
},
"volunteers": {
"type": "integer"
},
"participants": {
"type": "integer"
},
"segment_price": {
"type": "number"
}
}
}Claim a new @in.actbook.app forward target (write scope). localpart is the bit before @ (globally unique — try company-user if taken). owner='shared' (default, whole team) or 'me' (this key's user, personal). Optional label.
| Argument | Type | Description |
|---|---|---|
| label | string | |
| owner | string | |
| localpart* | string |
{
"type": "object",
"required": [
"localpart"
],
"properties": {
"label": {
"type": "string"
},
"owner": {
"type": "string"
},
"localpart": {
"type": "string"
}
}
}Add a policy to the insurance vault. type = coi|liability|workers_comp|license|other; optionally carrier, policy_number, coverage_amount, effective_date, expiry_date (YYYY-MM-DD), notes. To attach the document, pass file_base64 (a PDF/JPG/PNG) + file_name.
| Argument | Type | Description |
|---|---|---|
| type | string | |
| notes | string | |
| carrier | string | |
| file_name | string | |
| expiry_date | string | |
| file_base64 | string | |
| policy_number | string | |
| effective_date | string | |
| coverage_amount | string |
{
"type": "object",
"required": [],
"properties": {
"type": {
"type": "string"
},
"notes": {
"type": "string"
},
"carrier": {
"type": "string"
},
"file_name": {
"type": "string"
},
"expiry_date": {
"type": "string"
},
"file_base64": {
"type": "string"
},
"policy_number": {
"type": "string"
},
"effective_date": {
"type": "string"
},
"coverage_amount": {
"type": "string"
}
}
}Add a line item to a booking (e.g. 'extra half hour', travel). The amount (price x quantity) is added to the booking total.
| Argument | Type | Description |
|---|---|---|
| id* | integer | |
| price* | number | |
| quantity | number | |
| description* | string |
{
"type": "object",
"required": [
"id",
"description",
"price"
],
"properties": {
"id": {
"type": "integer"
},
"price": {
"type": "number"
},
"quantity": {
"type": "number"
},
"description": {
"type": "string"
}
}
}Add a note to the account's shared notepad (a general team scratchpad, NOT attached to any client or booking). To note something on a client, use add_comment (or add_client_note) instead.
| Argument | Type | Description |
|---|---|---|
| note* | string |
{
"type": "object",
"required": [
"note"
],
"properties": {
"note": {
"type": "string"
}
}
}Add a public review profile clients who rate 4-5 stars are sent to (e.g. label 'Google', url of your Google review link). Manage these to steer happy clients to the platforms that matter to you.
| Argument | Type | Description |
|---|---|---|
| url* | string | |
| sort | integer | |
| label* | string |
{
"type": "object",
"required": [
"label",
"url"
],
"properties": {
"url": {
"type": "string"
},
"sort": {
"type": "integer"
},
"label": {
"type": "string"
}
}
}Provision a mailbox on a configured sending domain (orders an Exchange seat, creates the box, drops it into the warm-up pool. Once warm-up finishes it sends cold email for any campaign that uses all mailboxes; to start it gently earlier, add it to a campaign with set_campaign_mailboxes). local_part = the part before @ (e.g. 'hello'). Charges the first part-month to the card on file immediately — if the card is declined nothing is ordered — then the monthly per-mailbox fee from the next renewal. Each account has a mailbox limit (lower during its first month) and a per-domain limit; a 400 provision_error explains which was reached. Agent plan.
| Argument | Type | Description |
|---|---|---|
| id* | integer | |
| from_name | string | |
| local_part* | string | |
| display_name | string |
{
"type": "object",
"required": [
"id",
"local_part"
],
"properties": {
"id": {
"type": "integer"
},
"from_name": {
"type": "string"
},
"local_part": {
"type": "string"
},
"display_name": {
"type": "string"
}
}
}Add one section to the home page (write scope). type is one of hero/about/services/gallery/logos/video/testimonials/faq/booking-cta/contact (logos = a 'Trusted by' row of client logos: {heading, images[], names[]}); data holds that section's fields; optional after=<section id> to position it. Saves a draft. Optional act_id targets a per-act site (Agency only).
| Argument | Type | Description |
|---|---|---|
| data | object | |
| type* | string | |
| after | string | |
| act_id | integer |
{
"type": "object",
"required": [
"type"
],
"properties": {
"data": {
"type": "object"
},
"type": {
"type": "string"
},
"after": {
"type": "string"
},
"act_id": {
"type": "integer"
}
}
}Add a performer/staff member.
| Argument | Type | Description |
|---|---|---|
| nick* | string | |
| string | ||
| phone | string | |
| last_name | string | |
| first_name | string |
{
"type": "object",
"required": [
"nick"
],
"properties": {
"nick": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
},
"last_name": {
"type": "string"
},
"first_name": {
"type": "string"
}
}
}Block an address or a WHOLE DOMAIN from ever being emailed: entry='[email protected]' or entry='school.org' (every address at that domain); entries=[…] for a list. Any live sequence to it is stopped. Optional note.
| Argument | Type | Description |
|---|---|---|
| note | string | |
| entry | string | |
| entries | array |
{
"type": "object",
"required": [],
"properties": {
"note": {
"type": "string"
},
"entry": {
"type": "string"
},
"entries": {
"type": "array"
}
}
}Approve a pending online booking request — accept it, confirm the booking (it stops being a quote, so reminders and payment chasing apply), keep the held date, and email the client it's confirmed. The result's `notified` says whether that email actually went. Applies only to bookings that came in through the public booking page and are awaiting a decision (online_approval='pending' on the booking).
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Assign a team member to a gig date. Optionally set the commission/split payout for this assignment: pay_type = flat (pay_amount dollars) | hourly (pay_amount per hour of the shift) | percent (pay_amount percent of the gig's booking revenue); pay_amount is the dollar/hourly/percent figure. Omitting them keeps any existing payout. Read these back with get_payouts (Agency 'splits').
| Argument | Type | Description |
|---|---|---|
| end_time | string | |
| pay_type | string | |
| manager_id* | integer | |
| pay_amount | number | |
| start_time | string | |
| project_date_id* | integer |
{
"type": "object",
"required": [
"manager_id",
"project_date_id"
],
"properties": {
"end_time": {
"type": "string"
},
"pay_type": {
"type": "string"
},
"manager_id": {
"type": "integer"
},
"pay_amount": {
"type": "number"
},
"start_time": {
"type": "string"
},
"project_date_id": {
"type": "integer"
}
}
}Key numbers: upcoming gigs, gigs in the next 30 days, bookings this month, open quotes, active clients, booked value year-to-date.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Buy a domain for sending and begin its setup (registers it, attaches it to the sending tenant, writes mail DNS). Checks the domain is still available, then charges the yearly domain fee to the card on file right away (refunded automatically if registration fails; fails cleanly with no charge if the card is declined). Returns the domain with its setup status; poll get_sending_domain until status is 'configured', then add_sending_mailbox. Agent plan.
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
}
}One campaign's deliverability + funnel stats and rates.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Cancel a sending domain: cancels all its mailboxes (at period end) and turns off auto-renew, so the domain lapses at expiry. If the customer wants to keep the domain, call transfer_out_domain first.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Cancel a sending mailbox. Stops at the END of the paid period — it keeps working and warming until then, then the box is torn down and the $10/mo stops. id = the sending domain's id, mailbox_id = the mailbox.
| Argument | Type | Description |
|---|---|---|
| id* | integer | |
| mailbox_id* | integer |
{
"type": "object",
"required": [
"id",
"mailbox_id"
],
"properties": {
"id": {
"type": "integer"
},
"mailbox_id": {
"type": "integer"
}
}
}Booked dates in a month, or whether a specific date is free (pass date=YYYY-MM-DD).
| Argument | Type | Description |
|---|---|---|
| date | string | |
| month | string |
{
"type": "object",
"required": [],
"properties": {
"date": {
"type": "string"
},
"month": {
"type": "string"
}
}
}Claim an open network referral; returns the client's contact details. Requires network opt-in.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Mark a to-do done.
| Argument | Type | Description |
|---|---|---|
| id* | integer | |
| done | boolean |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
},
"done": {
"type": "boolean"
}
}
}Connect Apple iCloud Calendar for two-way sync (write scope). Needs the Apple ID email and an APP-SPECIFIC password (not their normal Apple password): appleid.apple.com -> Sign-In and Security -> App-Specific Passwords -> generate one named "ActBook". write=new (default) puts gigs in a new "ActBook gigs" calendar; write=later connects without writing gigs until a calendar is chosen with update_apple_calendar. busy_calendars (urls) defaults to every calendar except the gigs one. Only ask the user for the password if they offer it; otherwise send them to /calendar -> Calendars.
| Argument | Type | Description |
|---|---|---|
| write | string | |
| apple_id* | string | |
| app_password* | string | |
| busy_calendars | array |
{
"type": "object",
"required": [
"apple_id",
"app_password"
],
"properties": {
"write": {
"enum": [
"new",
"later"
],
"type": "string"
},
"apple_id": {
"type": "string"
},
"app_password": {
"type": "string"
},
"busy_calendars": {
"type": "array",
"items": {
"type": "string"
}
}
}
}Connect a domain or subdomain the customer ALREADY owns (registered at GoDaddy/Cloudflare/etc.) for sending — no domain purchase, no domain charge. A dedicated subdomain (e.g. go.theirband.com) is strongly recommended: it keeps their main email and root-domain reputation untouched. We attach it to the sending tenant and return the DNS records they must add at their registrar; poll sending_domain_dns for the exact records + live present/missing status, and get_sending_domain to advance setup. WARNING: a bare root domain they already use for email will have its mail disrupted when its MX is pointed to us. Agent plan.
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
}
}Add a performer act (name max 50 chars).
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| notes | string | |
| day_rate | number | |
| travel_fee | number | |
| travel_radius_miles | integer |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"notes": {
"type": "string"
},
"day_rate": {
"type": "number"
},
"travel_fee": {
"type": "number"
},
"travel_radius_miles": {
"type": "integer"
}
}
}Create a booking (or a quote with is_quote:true — defaults to a confirmed booking). start_time/end_time accept HH:MM (24h) or plain forms like '6pm'/'6:00 PM'. participants/volunteers set the headcount (default from the package if omitted). comments PRINT on the contract (client-facing detail); manager_notes are internal and do NOT print (put provenance like 'from handwritten note' here). Several dates on one booking: pass dates=[{date, start_time, end_time, project_type_id, price, act_id}, ...] (the first is the main date; price defaults to the SUM of the dates' prices). act_id per date only applies when the account has 'Book multiple acts per booking' on (setting multi_act_booking, Agent plan); otherwise every date gets the booking's act_id.
| Argument | Type | Description |
|---|---|---|
| date | string | |
| dates | array | |
| price | number | |
| act_id | integer | |
| deposit | integer | |
| project | string | |
| comments | string | |
| end_time | string | |
| is_quote | boolean | |
| client_id | integer | |
| start_time | string | |
| volunteers | integer | |
| participants | integer | |
| manager_notes | string | |
| project_type_id | integer | |
| contract_template | integer |
{
"type": "object",
"required": [],
"properties": {
"date": {
"type": "string"
},
"dates": {
"type": "array",
"items": {
"type": "object",
"required": [
"date"
],
"properties": {
"date": {
"type": "string"
},
"price": {
"type": "number"
},
"act_id": {
"type": "integer"
},
"end_time": {
"type": "string"
},
"start_time": {
"type": "string"
},
"project_type_id": {
"type": "integer"
}
}
}
},
"price": {
"type": "number"
},
"act_id": {
"type": "integer"
},
"deposit": {
"type": "integer"
},
"project": {
"type": "string"
},
"comments": {
"type": "string"
},
"end_time": {
"type": "string"
},
"is_quote": {
"type": "boolean"
},
"client_id": {
"type": "integer"
},
"start_time": {
"type": "string"
},
"volunteers": {
"type": "integer"
},
"participants": {
"type": "integer"
},
"manager_notes": {
"type": "string"
},
"project_type_id": {
"type": "integer"
},
"contract_template": {
"type": "integer"
}
}
}Make (or replace) a trade show's booth staff link. last_day (YYYY-MM-DD, the show's last day; default today, at most 60 days ahead) — the link closes by itself at 3 AM the next morning, account time. Returns url + pin to hand to the helpers. Replacing an existing link signs every phone out at once, so only do it when the user asks for a new link or PIN.
| Argument | Type | Description |
|---|---|---|
| id* | integer | |
| last_day | string |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
},
"last_day": {
"type": "string"
}
}
}Create a DRAFT email broadcast to a segment of your clients. segment is a ClientSelect filter object, e.g. {"tag":12,"state":"MI","near_zip":"48104","radius_miles":50,"q":"library","has_email":true}; omit it to reach all contactable clients. Use {{first_name}} in the subject/body. Does NOT send — call send_broadcast.
| Argument | Type | Description |
|---|---|---|
| name | string | |
| segment | object | |
| subject* | string | |
| reply_to | string | |
| body_html | string | |
| from_name | string | |
| tracking_enabled | boolean |
{
"type": "object",
"required": [
"subject"
],
"properties": {
"name": {
"type": "string"
},
"segment": {
"type": "object",
"additionalProperties": true
},
"subject": {
"type": "string"
},
"reply_to": {
"type": "string"
},
"body_html": {
"type": "string"
},
"from_name": {
"type": "string"
},
"tracking_enabled": {
"type": "boolean"
}
}
}Create a client (optionally with a contact name/email/phone).
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| string | ||
| phone | string |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"phone": {
"type": "string"
}
}
}Create a new client from an inbox message's sender (write scope) and link the message to it. Returns the new client_id.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Add a reusable contract clause (title max 50 chars).
| Argument | Type | Description |
|---|---|---|
| title* | string | |
| clause | string | |
| act_clause | boolean | |
| conditional | string | |
| client_clause | boolean |
{
"type": "object",
"required": [
"title"
],
"properties": {
"title": {
"type": "string"
},
"clause": {
"type": "string"
},
"act_clause": {
"type": "boolean"
},
"conditional": {
"type": "string"
},
"client_clause": {
"type": "boolean"
}
}
}Create a bookable package / event type (name max 20 chars). price_mode = flat | per_guest (included_participants free, then price_per_participant each) | block (block_size guests per circuit, +block_extra_price per extra circuit) | menu. volunteer_mode = fixed (default_volunteers) | per_circuit (default_volunteers × circuits) | per_participants (1 per default_volunteers guests). requires_prep=true pairs it with a required prep meeting of prep_type_id (another event type id) on the same booking, ending before it starts. stock_qty = how many physical units of this you own (bounce houses, extra photo booths): each date takes that many bookings of it, and they don't block the performer's other bookings; omit/null for a normal show.
| Argument | Type | Description |
|---|---|---|
| cost | number | |
| name* | string | |
| act_id | integer | |
| stock_qty | integer | |
| block_size | integer | |
| price_mode | string | |
| at_facility | boolean | |
| description | string | |
| max_per_day | integer | |
| prep_type_id | integer | |
| setup_length | integer | |
| requires_prep | boolean | |
| running_length | integer | |
| volunteer_mode | string | |
| block_tolerance | integer | |
| bookable_online | boolean | |
| teardown_length | integer | |
| min_participants | integer | |
| block_extra_price | number | |
| default_volunteers | integer | |
| default_participants | integer | |
| included_participants | integer | |
| price_per_participant | number |
{
"type": "object",
"required": [
"name"
],
"properties": {
"cost": {
"type": "number"
},
"name": {
"type": "string"
},
"act_id": {
"type": "integer"
},
"stock_qty": {
"type": "integer"
},
"block_size": {
"type": "integer"
},
"price_mode": {
"type": "string"
},
"at_facility": {
"type": "boolean"
},
"description": {
"type": "string"
},
"max_per_day": {
"type": "integer"
},
"prep_type_id": {
"type": "integer"
},
"setup_length": {
"type": "integer"
},
"requires_prep": {
"type": "boolean"
},
"running_length": {
"type": "integer"
},
"volunteer_mode": {
"type": "string"
},
"block_tolerance": {
"type": "integer"
},
"bookable_online": {
"type": "boolean"
},
"teardown_length": {
"type": "integer"
},
"min_participants": {
"type": "integer"
},
"block_extra_price": {
"type": "number"
},
"default_volunteers": {
"type": "integer"
},
"default_participants": {
"type": "integer"
},
"included_participants": {
"type": "integer"
},
"price_per_participant": {
"type": "number"
}
}
}Add a reusable letter/email body (title max 30 chars). Set default=true to make it the default.
| Argument | Type | Description |
|---|---|---|
| body | string | |
| title* | string | |
| default | boolean |
{
"type": "object",
"required": [
"title"
],
"properties": {
"body": {
"type": "string"
},
"title": {
"type": "string"
},
"default": {
"type": "boolean"
}
}
}Create a cold-email outreach campaign (draft). Open/click tracking is OFF unless tracking_enabled=true: tracking adds a hidden image and sends links through actbook.app, which makes cold email likelier to land in spam; replies are counted either way.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| reply_to | string | |
| from_name | string | |
| from_email | string | |
| tracking_enabled | boolean |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"reply_to": {
"type": "string"
},
"from_name": {
"type": "string"
},
"from_email": {
"type": "string"
},
"tracking_enabled": {
"type": "boolean"
}
}
}Create a to-do (item max 50 chars; longer text in details). Optionally tie it to a booking/client, set due_date ('YYYY-MM-DD' or 'YYYY-MM-DD HH:MM:SS') and urgent. It lands on the dashboard of the user this key belongs to, or assign_to (a teammate's login or user_id); is_global shows it to everyone.
| Argument | Type | Description |
|---|---|---|
| item* | string | |
| urgent | boolean | |
| details | string | |
| due_date | string | |
| assign_to | string | |
| client_id | integer | |
| is_global | boolean | |
| booking_id | integer |
{
"type": "object",
"required": [
"item"
],
"properties": {
"item": {
"type": "string"
},
"urgent": {
"type": "boolean"
},
"details": {
"type": "string"
},
"due_date": {
"type": "string"
},
"assign_to": {
"type": "string"
},
"client_id": {
"type": "integer"
},
"is_global": {
"type": "boolean"
},
"booking_id": {
"type": "integer"
}
}
}Create a trade-show booth sign-up (available on every plan). name required. Optional campaign_id links a follow-up outreach sequence (must belong to this account; needs the outreach plan to actually send). sms_enabled + sms_message fire an instant text to each scan. poster_cta is the line printed under the QR code (default "Scan to book us!"). Returns the token and public_url for the QR code.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| poster_cta | string | |
| campaign_id | integer | |
| sms_enabled | boolean | |
| sms_message | string |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"poster_cta": {
"type": "string"
},
"campaign_id": {
"type": "integer"
},
"sms_enabled": {
"type": "boolean"
},
"sms_message": {
"type": "string"
}
}
}Create a login user (password min 8 chars; email required — sign-in is by email). Needs a connection holding write + money + comms, made by a user allowed to manage users. TWO KINDS: (1) a FULL user: access_level 1-5 (you can only create logins below your own level; is_admin for full access). (2) a LIMITED user: type='limited' plus either preset (booth_staff | performer | office_assistant | bookkeeper | marketing) or permissions, an object of tool area => 'full' or 'view' (areas: tradeshows, calendar, bookings, clients, contracts, payments, inbox, outreach, reports, website; 'view' exists for calendar, bookings and clients only). Tools that another tool needs are added automatically and the saved set is returned — e.g. to add someone who can ONLY use the trade-show tools: type='limited', preset='booth_staff'. A limited user never reaches settings, users, billing or API keys, and counts as a plan seat. See list_user_permissions for the areas, what each needs and what each preset ticks. Limit to certain acts: act_restricted=true + act_ids (the performer preset sets act_restricted for you — still send act_ids).
| Argument | Type | Description |
|---|---|---|
| type | string | |
| email* | string | |
| login* | string | |
| preset | string | |
| act_ids | array | |
| is_admin | boolean | |
| password* | string | |
| last_name | string | |
| first_name | string | |
| permissions | object | |
| access_level | string | |
| act_restricted | boolean |
{
"type": "object",
"required": [
"login",
"password",
"email"
],
"properties": {
"type": {
"enum": [
"full",
"limited"
],
"type": "string"
},
"email": {
"type": "string"
},
"login": {
"type": "string"
},
"preset": {
"enum": [
"booth_staff",
"performer",
"office_assistant",
"bookkeeper",
"marketing"
],
"type": "string"
},
"act_ids": {
"type": "array"
},
"is_admin": {
"type": "boolean"
},
"password": {
"type": "string"
},
"last_name": {
"type": "string"
},
"first_name": {
"type": "string"
},
"permissions": {
"type": "object"
},
"access_level": {
"type": "string"
},
"act_restricted": {
"type": "boolean"
}
}
}Subscribe a URL to events. events is a comma-separated list or 'all'. Returns the signing secret once.
| Argument | Type | Description |
|---|---|---|
| events | string | |
| target_url* | string |
{
"type": "object",
"required": [
"target_url"
],
"properties": {
"events": {
"type": "string"
},
"target_url": {
"type": "string"
}
}
}Delete a performer act.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Archive a locker document by id (soft — it stops appearing and can't be sent).
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Archive (soft-delete) a booking.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Archive (soft-delete) a client.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Delete an activity note.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Remove a contact from a client.
| Argument | Type | Description |
|---|---|---|
| clientId* | integer | |
| contactId* | integer |
{
"type": "object",
"required": [
"clientId",
"contactId"
],
"properties": {
"clientId": {
"type": "integer"
},
"contactId": {
"type": "integer"
}
}
}Delete a reusable contract clause.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Remove a gig date from a booking.
| Argument | Type | Description |
|---|---|---|
| id* | integer | |
| date_id* | integer |
{
"type": "object",
"required": [
"id",
"date_id"
],
"properties": {
"id": {
"type": "integer"
},
"date_id": {
"type": "integer"
}
}
}Remove a client document (soft-delete, write scope).
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Delete a bookable package/event type.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Permanently delete one inbox message (write scope).
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Delete a reusable letter/email body.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Delete a branch (comms scope). Leads waiting in it are released: back to the main sequence for ooo_return / clicked, finished for the others.
| Argument | Type | Description |
|---|---|---|
| id* | integer | |
| branch_id* | integer |
{
"type": "object",
"required": [
"id",
"branch_id"
],
"properties": {
"id": {
"type": "integer"
},
"branch_id": {
"type": "integer"
}
}
}Delete a recorded payment from a booking (money scope).
| Argument | Type | Description |
|---|---|---|
| id* | integer | |
| payment_id* | integer |
{
"type": "object",
"required": [
"id",
"payment_id"
],
"properties": {
"id": {
"type": "integer"
},
"payment_id": {
"type": "integer"
}
}
}Delete a shared-notepad note.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Delete a to-do.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Delete a trade show permanently. To just get a finished show out of the way (reversibly), use update_trade_show with archived=true instead.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Remove (soft-delete) a login user. Needs a connection holding write + money + comms; only logins below your own access level (owners: anyone).
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Delete a webhook subscription.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Deny a pending online booking request — decline it, free the held date, and email the client it's unavailable.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Disconnect Apple iCloud Calendar (write scope). Gigs already in iCloud stay there; ActBook stops updating them and forgets the iCloud busy times. Confirm with the user first.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Mark a past client as not worth a re-book nudge right now (no message is sent); removes them from the active re-book list for their current last booking.
| Argument | Type | Description |
|---|---|---|
| client_id* | integer |
{
"type": "object",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "integer"
}
}
}Email the booking's itemised invoice (PDF) to the client (comms scope).
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Permanently delete all spam visible to this key (write scope). Returns how many were removed.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Enroll a whole selection of clients into an outreach campaign (one prospect per client, using their email on file). Target with client_ids or the list_clients selection filters; campaign_id is the outreach campaign. dry_run=true previews counts without enrolling. Returns enrolled / skipped_no_email / skipped_other / matched. This is how you 'drop a tag into a campaign' — e.g. filter tag=<id> then enroll.
| Argument | Type | Description |
|---|---|---|
| q | string | |
| tag | integer | |
| state | string | |
| county | string | |
| dry_run | boolean | |
| near_zip | string | |
| has_email | boolean | |
| has_phone | boolean | |
| client_ids | array | |
| campaign_id* | integer | |
| near_client | integer | |
| county_state | string | |
| radius_miles | number |
{
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"q": {
"type": "string"
},
"tag": {
"type": "integer"
},
"state": {
"type": "string"
},
"county": {
"type": "string"
},
"dry_run": {
"type": "boolean"
},
"near_zip": {
"type": "string"
},
"has_email": {
"type": "boolean"
},
"has_phone": {
"type": "boolean"
},
"client_ids": {
"type": "array"
},
"campaign_id": {
"type": "integer"
},
"near_client": {
"type": "integer"
},
"county_state": {
"type": "string"
},
"radius_miles": {
"type": "number"
}
}
}Enroll prospects into a campaign: prospects=[{email, first_name, ...}]. dry_run=true previews.
| Argument | Type | Description |
|---|---|---|
| id* | integer | |
| dry_run | boolean | |
| prospects* | array |
{
"type": "object",
"required": [
"id",
"prospects"
],
"properties": {
"id": {
"type": "integer"
},
"dry_run": {
"type": "boolean"
},
"prospects": {
"type": "array"
}
}
}Preview the national buyer directory near a location. Buyer types: school, preschool (preschools & daycares), library, theater, fair, festival, parks (parks & recreation depts), museum, senior (senior-living/retirement communities), country_club, church, college (colleges & universities), live_music_venue (bars/restaurants that host live music), sports (pro NBA/WNBA + NCAA Division I teams). Returns total + counts by type + a small sample (no contact details). Give location (address or zip) OR lat & lng, a radius in miles, and optional types. Coverage for live_music_venue, preschool, parks, country_club, church and festival is still rolling out area-by-area, so a 0 count there just means that region isn't loaded yet. To actually receive verified contacts, place a lead order (order_leads), which spends lead credits.
| Argument | Type | Description |
|---|---|---|
| lat | number | |
| lng | number | |
| types | string | |
| states | string | |
| location | string | |
| radius_mi | number |
{
"type": "object",
"required": [],
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"types": {
"type": "string"
},
"states": {
"type": "string"
},
"location": {
"type": "string"
},
"radius_mi": {
"type": "number"
}
}
}Find likely-duplicate client pairs (same name & location, a shared email, or a shared phone). Returns each pair with both records, their booking counts, the match reason(s), and a suggested survivor (suggest_keep). Feed a pair to merge_clients: id = the one to absorb, into = the one to keep (use suggest_keep).
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Find WHERE a setting is, WHAT it does, and HOW to reach it. Search the curated settings catalog by plain language (e.g. 'reply-to email', 'deposits', 'travel time', 'white label', 'timezone', 'api keys'). Each result has a one-line explanation, the page it lives on, and a deep_link that lands on the exact control. Omit q to list every setting. Use this instead of guessing which page a setting is on.
| Argument | Type | Description |
|---|---|---|
| q | string |
{
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string"
}
}
}The account's scheduling rules: weekly working hours, min notice, booking window, buffer, max bookings/day.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}One booking with its dates, line items and payments.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}One booth capture by id, with its contact fields, notes, enrichment status and linked inquiry_id.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}A trade show's booth staff link: the link + PIN that lets temporary helpers WITHOUT an ActBook login capture leads for that one show from their own phone (available on every plan; no user seat). Returns state (active/paused/expired), when it closes, the url and pin, and who has signed in with how many leads each. staff_link is null when the show has none.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}The account's logo (printed at the top of contracts and invoices) and each user's signature image (printed on contracts they book).
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}One broadcast with its results (sent, opened, clicked, unsubscribed, bounced).
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}This user's two-way calendar sync: Google (connected?, email, last sync/error — connecting Google is a browser sign-in at connect_url) and Apple iCloud (connected Apple ID, the calendar gigs are written to, which calendars count as busy, every iCloud calendar with its url, gigs synced, busy events read, last sync/error). Never returns passwords.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}The signed-in user's default calendar views: which view /calendar opens in on a computer (desktop) and on a phone (phone) — month, week or list.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}One client with its contacts (names, emails, phones) and its 10 most recent notes (recent_comments).
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Render a booking's contract. format=html (default) returns HTML; format=pdf returns the PDF base64-encoded. Optional template_id.
| Argument | Type | Description |
|---|---|---|
| id* | integer | |
| format | string | |
| template_id | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
},
"format": {
"type": "string"
},
"template_id": {
"type": "integer"
}
}
}One SMS conversation thread by client id.
| Argument | Type | Description |
|---|---|---|
| clientId* | integer |
{
"type": "object",
"required": [
"clientId"
],
"properties": {
"clientId": {
"type": "integer"
}
}
}Get a short-lived (5 minute) download URL for a client document by its doc id.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}The warm lead-follow-up sequence (available on every plan): the emails that auto-send to the leads you capture at a booth/show, from your own mailbox — distinct from the Agent cold-outreach engine. Returns status (active/draft), the sending mailbox, the ordered steps, and the connected mailboxes you can send from. One auto-provisioned sequence per account.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}One gift certificate by number.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}One inbox message by id, including its full body text.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}One lead/enquiry in full.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}The invoice for a booking: total, paid, balance, payments.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}This account's prepaid lead-credit balance and recent ledger (purchases, grants, delivery charges).
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}One buyer-lead order with its progress (delivered/enriched counts).
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}One sending/receiving email account (secrets hidden), incl. warm-up health: warmup.inbox_rate and warmup.placement = where its warm-up mail landed at real Gmail/Outlook/Yahoo inboxes over 14 days (our own-server filler excluded).
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Discovery-call meeting settings: whether a 'request a call' link is enabled, the video provider (zoom|google_meet|manual), the static meeting link, length, topic, and pad_travel (whether offered slots guard each show's setup, teardown & travel time). Use {{meeting_link}} in an outreach step to invite prospects to book a call.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}One outreach campaign with its steps, and 'sending': what its mailboxes can deliver a day at their gaps (reachable_per_day, limit_reachable), each mailbox's daily limit / gap / provider, and the mail providers its leads are on (lead_providers, lead_provider_note).
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}A campaign's BRANCHES: short sets of emails that start when something happens to a lead. Triggers: no_reply (finished the sequence without replying → e.g. one last note, or a re-approach next season), ooo_return (back from an out-of-office → a welcome-back email, then the main sequence carries on), clicked (clicked a link; needs tracking on → these emails instead of the rest of the sequence), reply_phrase (their reply contained a phrase such as 'next year' and was not a clear no → a re-approach after wait_days; the reply still goes to the pipeline). Each branch has stats {entered, waiting, sent, replied}. A human reply always stops automation; branch emails count toward the campaign's daily limit.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}This account's ActBook referral link (and the link its QR code carries) and what the partner programme has earned it: link clicks, QR scans, sign-ups, paying customers, commission earned / still in the 30-day wait / ready to pay out / paid, the next payout date, and each referred account by business name with what it earned. Read-only. A partner earns 20% of what an account they referred pays for its plan in its first 12 months, paid by PayPal once a month from $50. An ActBook subscriber who refers ALSO earns 10% of the referred plan's price as an ongoing ActBook-Bucks credit on their own bill, for as long as both accounts stay subscribed (on top of the first-year cash); a non-subscriber partner earns the first-year cash only. Joining (signing the agreement, PayPal address) is done by a person on the Refer page (/refer); payouts are made by ActBook and cannot be requested here. enabled=false means the cash programme is not open yet; joined=false means the agreement has not been signed.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Commission & split report (Agency 'splits' feature): per-performer payout, the booking revenue their gigs represent, and the agency margin (revenue − payouts), plus summary totals, over a date range. from/to = YYYY-MM-DD (default the current month).
| Argument | Type | Description |
|---|---|---|
| to | string | |
| from | string |
{
"type": "object",
"required": [],
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
}
}
}The booking pipeline as lifecycle lanes (Proposal sent [lane key 'quote'], Contract & deposit [key 'contract'], Confirmed, Balance due, Lost). Each lane lists its bookings with totals, paid and balance; Contract & deposit bookings carry open_steps — any of send_contract (your move), awaiting_signature, deposit_due. Stage is computed from the booking's state.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}The latest INBOX-PLACEMENT TEST of a campaign: its first email, sent from each of its sending mailboxes to a few mailboxes ActBook reads, and where each landed — inbox / spam / not found per mailbox and per provider (Google, Microsoft, other), SPF/DKIM/DMARC as the receiver recorded them, and findings in plain words. It is a small sample: a signal, not a guarantee (and Gmail's Promotions tab is not visible to it). seed_mailboxes shows how many test mailboxes exist per provider.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}A detailed report over a date range. name = income | revenue-by-act | average-booking | appearances | conversion | repeat | mileage | business-history. from/to = YYYY-MM-DD (default this year). mileage = one-way + round-trip driving miles from the home base to each gig (tax mileage); distances are cached per date, lookups caps fresh Google lookups per call (default 50) and rows with status=pending fill on the next call. business-history = the whole life of the business, one row per year (ignores from/to): performed that year by gig date (total fees, bookings, gigs, averages, year-over-year change), booked that year by booking date, booking balance (booked − performed) and the running 'on the books' total; status is complete | so_far (the current year) | booked_ahead (future years with gigs). Lost bookings are left out unless include_lost=true.
| Argument | Type | Description |
|---|---|---|
| to | string | |
| from | string | |
| name* | string | |
| lookups | integer | |
| include_lost | boolean |
{
"type": "object",
"required": [
"name"
],
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"name": {
"type": "string"
},
"lookups": {
"type": "integer"
},
"include_lost": {
"type": "boolean"
}
}
}Advance and read one sending domain's setup state (registration → added → verified → configured). Call after buy_domain/connect_sending_domain until it reports 'configured'.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}All account settings (company info, booking config, labels). Includes account_mode: 'performer' (the full booking app) or 'general' (a leads-only account for non-performers — capture + follow-up, no acts/shows).
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}The tenant's free website: its content document (pages/sections), publish status, the live + preview URLs, available section types, a summary of the live data the site pulls in (company name, bookable packages, booking link), and (sites) the list of all this tenant's sites with their act_id. Read this first before editing. Optional act_id edits a per-act site instead of the primary one (Agency tenants only; act_id 0/omitted = the primary site).
| Argument | Type | Description |
|---|---|---|
| act_id | integer |
{
"type": "object",
"required": [],
"properties": {
"act_id": {
"type": "integer"
}
}
}Your public 'join my mailing list' signup form: the shareable link + embed URL, which tag new subscribers land in, and the current list size. Share the link to grow the list; broadcast to them with create_broadcast using that tag.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}One support ticket with its full message thread.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}The account's own texting (SMS) number, or — when it has none yet — whether one can be set up and why not. Every account texts from a number of its own; nothing is sent until it has one.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}One signed waiver by id, with its pass URL.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}Build the tenant's ActBook site by importing their EXISTING website (WordPress, Squarespace, plain HTML…). Pulls their title, bio, video, performer photos (hero + gallery) and contact into a structured DRAFT (editorial theme) and self-hosts the images; client logos are kept out of the photos and go to a 'logos' row. Review/edit the result with get_site, then publish_site. Does NOT publish automatically. Great first step when a performer already has a site. The response includes a rights notice — the tenant is responsible for having the rights to any imported images/text; only publish media they own or are licensed to use. Optional act_id imports into a per-act site (Agency only).
| Argument | Type | Description |
|---|---|---|
| url* | string | |
| act_id | integer | |
| self_host_images | boolean |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
},
"act_id": {
"type": "integer"
},
"self_host_images": {
"type": "boolean"
}
}
}Issue a gift certificate (money scope). amount required; optional code, purchaser, recipient, paid_amount, paid_by, comments.
| Argument | Type | Description |
|---|---|---|
| code | string | |
| amount* | number | |
| paid_by | string | |
| comments | string | |
| purchaser | string | |
| recipient | string | |
| paid_amount | number |
{
"type": "object",
"required": [
"amount"
],
"properties": {
"code": {
"type": "string"
},
"amount": {
"type": "number"
},
"paid_by": {
"type": "string"
},
"comments": {
"type": "string"
},
"purchaser": {
"type": "string"
},
"recipient": {
"type": "string"
},
"paid_amount": {
"type": "number"
}
}
}The performer acts/catalog with day rate and travel settings.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Document & media locker (Agent+ 'coi' feature): the account's sendable business documents — W-9, publicity photos, contract rider, stage plot, bio, press kit, logo, set list, direct-deposit form and more. Each has a category, a title, and either a stored file or an external link. Filter by category (w9|photo|rider|stage_plot|tech_spec|bio|press_kit|logo|setlist|ach|other). Use send_assets to email one or several to a client.
| Argument | Type | Description |
|---|---|---|
| category | string | |
| include_archived | boolean |
{
"type": "object",
"required": [],
"properties": {
"category": {
"type": "string"
},
"include_archived": {
"type": "boolean"
}
}
}Who is assigned to a gig date (pass project_date_id).
| Argument | Type | Description |
|---|---|---|
| project_date_id* | integer |
{
"type": "object",
"required": [
"project_date_id"
],
"properties": {
"project_date_id": {
"type": "integer"
}
}
}Every automation: the pre-event check-in email (sent a set number of days BEFORE the gig, offset_days negative; default a week before), the day-of SMS, thank-you email, review request and next-year re-book email (each with its timing, template and mailbox_id = the 'Send from' mailbox, null = team default), the payment chase (balance reminders: master on/off, send hour, sender, and six stages due_soon/due_tomorrow/overdue/overdue_7/overdue_14/overdue_30 with offset_days relative to the event day and their subject/body), the contract chase (re-emails the signing link when a contract was sent but not signed: master on/off, send hour, sender, and three stages first/second/final with offset_days = days AFTER the contract was sent), and the mailboxes automations may send from. The re-book email is timed lead_value lead_unit BEFORE the anniversary of the date the booking was made (not the gig date) — the same rule list_rebooking uses.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Unavailable date ranges (blackouts) that block online booking.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}The account's BLOCK LIST: addresses and whole domains that are never emailed, in any campaign or newsletter. People who unsubscribe, bounce or are checked invalid land here by themselves. Use it to answer 'who unsubscribed' (reason=unsubscribed, optionally campaign_id). Optional q (search), reason = unsubscribed | bounced | invalid | complaint | manual | imported | other, kind = address | domain, campaign_id, limit, offset. Returns {entries:[{id, value, is_domain, reason_label, campaign, note, created_at}], total, counts}.
| Argument | Type | Description |
|---|---|---|
| q | string | |
| kind | string | |
| limit | integer | |
| offset | integer | |
| reason | string | |
| campaign_id | integer |
{
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string"
},
"kind": {
"type": "string"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"reason": {
"type": "string"
},
"campaign_id": {
"type": "integer"
}
}
}List bookings. Filter by q (text), status (all|confirmed|quotes), upcoming=true (next gig today or later) or past=true (last gig date before today), and/or a gig-date range from/to (YYYY-MM-DD; keeps bookings whose gig dates overlap it). Filters combine. Each row has first_date and last_date (its gig span).
| Argument | Type | Description |
|---|---|---|
| q | string | |
| to | string | |
| from | string | |
| past | boolean | |
| limit | integer | |
| offset | integer | |
| status | string | |
| upcoming | boolean |
{
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string"
},
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"past": {
"type": "boolean"
},
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"status": {
"type": "string"
},
"upcoming": {
"type": "boolean"
}
}
}Recent booth captures synced from the field: the entered/OCR'd contact fields (name/email/phone/company/title), notes, OCR + transcript status, and the pipeline inquiry_id each created. Optional trade_show_id filters to one show; limit caps rows.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| trade_show_id | integer |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer"
},
"trade_show_id": {
"type": "integer"
}
}
}Email broadcasts to your OWN clients (newsletters / announcements), with their open/click stats. Different from outreach, which is cold email to prospects.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}The bookings/quotes for a client.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}List the documents attached to a client (e.g. scanned contracts). Each has a download link via get_document_download.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}List / SELECT clients. This is the marketing selection engine: filter by q (name), tag (a grouping_id from the account's tags), state (2-letter), county (+ county_state), near_zip OR near_client (a client_id) with radius_miles for a geo radius, and has_email / has_phone (true to require one on file). Filters AND together. Each row has clients_id, name, city, state, zip, email, phone. Use the same filters with tag_clients, enroll_clients or make_call_list to act on the whole selection.
| Argument | Type | Description |
|---|---|---|
| q | string | |
| tag | integer | |
| limit | integer | |
| state | string | |
| county | string | |
| offset | integer | |
| near_zip | string | |
| has_email | boolean | |
| has_phone | boolean | |
| near_client | integer | |
| county_state | string | |
| radius_miles | number |
{
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string"
},
"tag": {
"type": "integer"
},
"limit": {
"type": "integer"
},
"state": {
"type": "string"
},
"county": {
"type": "string"
},
"offset": {
"type": "integer"
},
"near_zip": {
"type": "string"
},
"has_email": {
"type": "boolean"
},
"has_phone": {
"type": "boolean"
},
"near_client": {
"type": "integer"
},
"county_state": {
"type": "string"
},
"radius_miles": {
"type": "number"
}
}
}A client's (or booking's) notes / history — the comments log shown on the client page. Pass client_id or booking_id.
| Argument | Type | Description |
|---|---|---|
| client_id | integer | |
| booking_id | integer |
{
"type": "object",
"required": [],
"properties": {
"client_id": {
"type": "integer"
},
"booking_id": {
"type": "integer"
}
}
}Reusable contract paragraphs (clauses) and where they apply.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Contract templates (client and act kinds) and which is default.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}The SMS inbox: one row per client with unread counts.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}The gig dates on a booking (venue, times, setup, headcount).
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}A booking's event dates with event type, times, location and headcount.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}The bookable packages / event types with prices and durations.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Feedback/bug reports filed on this account.
| Argument | Type | Description |
|---|---|---|
| limit | integer |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer"
}
}
}Gift certificates. redeemed=0 (open, default), 1 (redeemed) or all.
| Argument | Type | Description |
|---|---|---|
| redeemed | string |
{
"type": "object",
"required": [],
"properties": {
"redeemed": {
"type": "string"
}
}
}The @in.actbook.app forward targets for this tenant — each maps to a shared inbox (whole team) or a personal one (a single user). Forward a real mailbox to one of these to pull its mail into ActBook.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}The email inbox: messages forwarded into ActBook. scope=all (your personal + shared, default), mine, shared, or spam. unread=true to show only unread; limit caps rows. Returns unread + spam counts too.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| scope | string | |
| unread | boolean |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer"
},
"scope": {
"type": "string"
},
"unread": {
"type": "boolean"
}
}
}Leads from the contact form. Filter by status (new|read|converted|archived|spam).
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| status | string |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer"
},
"status": {
"type": "string"
}
}
}Insurance / COI vault (Agent+ 'coi' feature): the account's stored policies (certificate of insurance, general liability, workers' comp, licence) with carrier, number, coverage, dates and a lapse flag (expiry_window: 60/30/7/expired). Use send_coi to get one to a venue.
| Argument | Type | Description |
|---|---|---|
| include_archived | boolean |
{
"type": "object",
"required": [],
"properties": {
"include_archived": {
"type": "boolean"
}
}
}This account's buyer-lead orders and their status (pending/processing/done).
| Argument | Type | Description |
|---|---|---|
| limit | integer |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer"
}
}
}Reusable email/letter bodies; one may be the default.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Line items on a booking.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}The account's sending/receiving email accounts (secrets hidden). Each also says can_send, outreach_ready (may carry cold email for a campaign that uses all mailboxes today), needs_pool (bought through ActBook and still warming: only sends for a campaign that names it) and bounce_visibility: inbox | graph | forwarded (ActBook learns about its bounces) or none (it does not — the mailbox is held to 20 cold emails a day until bounce notices are forwarded to an inbound address). Also provider (google | microsoft | yahoo | other — used for provider matching) and send_gap_min (its own gap between two cold emails; null = automatic).
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Cold-email outreach campaigns.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Suggested next moves for outreach: open cards, each a concrete next move for one campaign that waits for an approval. Kinds: raise_cap (replies are 2%+ and it keeps reaching its daily limit — approve raises the limit by up to 25%, never past what its mailboxes can send), add_mailbox (same, but the mailboxes are full), disable_variant (one A/B version is clearly losing once every version has had enough sends — approve switches it off), no_positive (100+ people emailed and nobody interested — approve holds NEW first emails while follow-ups continue), unsubs / bounces (how many more would trip the automatic safety pause), leads_low (under three sending days of new leads left), segments (a lead category not tried yet, or clearly ahead/behind). Returns {enabled, cards:[{id, campaign_id, kind, severity (warn|good|info), action, approvable, title, detail (what it saw), approve_label, approve_does (exactly what approving changes), if_ignored, metrics}]}. Nothing changes until a card is approved with resolve_outreach_review. If enabled is false, turn it on with set_outreach_review.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Payments recorded against a booking.
| Argument | Type | Description |
|---|---|---|
| id* | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer"
}
}
}The shared notepad; handled=done.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}List the leads in a campaign for per-lead management. Optional q (matches email/name/company), status (active|paused|removed|replied|unsubscribed|bounced|completed, or the two views out_of_office = active leads on hold because they sent an out-of-office, and in_branch = active leads inside a branch), page, per_page. Each row has ooo_until (the day they said they are back; they resume the day after) and in_branch/branch_id. Returns rows plus total and a per-status count breakdown.
| Argument | Type | Description |
|---|---|---|
| q | string | |
| id* | integer | |
| page | integer | |
| status | string | |
| per_page | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"q": {
"type": "string"
},
"id": {
"type": "integer"
},
"page": {
"type": "integer"
},
"status": {
"type": "string"
},
"per_page": {
"type": "integer"
}
}
}Past clients due (or coming up) to re-book. A client's re-book date is the account's re-book timing (lead_value lead_unit, default 30 days) BEFORE the anniversary of the date they made their last booking — events book months ahead, so that's when next year gets planned. Returns 'due' (re-book date within two weeks either side of today) and 'upcoming' (next 60 days), each client with last gig date, booked_on, value, anniversary, rebook_date, days_until_rebook and the nudge status (sent / dismissed / converted), plus the timing in force. Change the timing with update_automation type=rebook_email. Use nudge_rebooking to reach out.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Network gig referrals. type=pool (open gigs from other performers, default), mine (gigs you referred), or claims (gigs you claimed, with client details).
| Argument | Type | Description |
|---|---|---|
| type | string |
{
"type": "object",
"required": [],
"properties": {
"type": {
"type": "string"
}
}
}Reputation overview: summary stats (requests sent, rated, average stars, promoters/detractors, testimonials published), the configured public review destinations, and recent review requests with their rating, outcome and any private feedback. Reviews are collected by the review_request automation a couple of days after each gig.
| Argument | Type | Description |
|---|---|---|
| limit | integer |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer"
}
}
}Gigs on the calendar between two dates (default: the next 90 days). q = free-text search across client, project, act, show, venue, city/state and the date's notes — with q and no dates it searches ALL dates, past and future. act_id = only dates played by that act (comma-separate several; 0 = dates with no act). Each gig carries its effective act_id/act_name (the date's act, else the booking's, else the show's).
| Argument | Type | Description |
|---|---|---|
| q | string | |
| to | string | |
| from | string | |
| limit | integer | |
| act_id | string |
{
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string"
},
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"limit": {
"type": "integer"
},
"act_id": {
"type": "string"
}
}
}Your self-serve sending domains (bought through ActBook) and the mailboxes provisioned on each, with warm-up health. These are ActBook-operated M365 mailboxes used for cold outreach — different from mailboxes you connected yourself. While one is still warming up it only sends for a campaign that names it (set_campaign_mailboxes); a campaign set to use all mailboxes picks it up once warm-up has finished.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}List the images already uploaded to the tenant's website, as /media paths + urls. Optional act_id targets a per-act site (Agency only).
| Argument | Type | Description |
|---|---|---|
| act_id | integer |
{
"type": "object",
"required": [],
"properties": {
"act_id": {
"type": "integer"
}
}
}This account's support tickets (to the ActBook team) with status and last activity.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
}
}
}Performers/staff who can be assigned to gigs.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.
Takes a password, API key or token as an argument, so the secret passes through the model's context and chat logs.
Fix: Read credentials from the server's own configuration (environment, OAuth) instead of a tool argument.