# Fingertip

Fingertip is an all-in-one platform that enables businesses to manage their operations from a single link, offering tools for selling products, booking clients, and connecting with customers across various social media platforms.

- **Category:** website builders
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 60
- **Triggers:** 0
- **Slug:** `FINGERTIP`
- **Version:** 20260312_00

## Tools

### Create Store Invoice

**Slug:** `FINGERTIP_CREATE_INVOICE`

Tool to create a store invoice in Fingertip. Use when you need to bill a customer for products or services with line items, pricing, and tax details. Returns the created invoice ID which can be used to retrieve or manage the invoice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `memo` | string | No | Internal memo or note about this invoice (not visible to customer). |
| `dueAt` | string | No | Due date for the invoice in ISO 8601 format (e.g., '2024-12-31T23:59:59Z'). If not provided, invoice is due immediately. |
| `footer` | string | No | Footer text to display at the bottom of the invoice (e.g., payment terms, thank you message). |
| `siteId` | string | Yes | UUID of the site (store) for which the invoice is being created. |
| `status` | string ("DRAFT" | "PENDING" | "VOID" | "PAID" | "UNPAID" | "REFUNDED" | "PROCESSING") | No | Enumeration of possible invoice statuses. |
| `businessName` | string | No | Business name to display on the invoice. If not provided, uses the site's default business name. |
| `invoiceItems` | array | Yes | List of invoice items with pricing, quantity, and tax information. At least one item is required. |
| `siteContactId` | string | Yes | UUID of the contact (customer) who will receive the invoice. |
| `invoiceDiscounts` | array | No | List of discounts to apply to the invoice. Can be fixed amounts or percentages. |
| `paymentReference` | string | No | External payment reference or order number to associate with this invoice. |
| `passThroughPaymentFee` | boolean | No | If true, payment processing fees are passed through to the customer. Default is false. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Invoice Item

**Slug:** `FINGERTIP_CREATE_INVOICE_ITEM`

Creates a new invoice item for a Fingertip site. Requires siteId, title, and priceInCents. Returns the created invoice item with its unique ID and timestamps.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | Title of the invoice item |
| `siteId` | string | Yes | UUID of the site this invoice item belongs to |
| `description` | string | No | Optional description of the invoice item |
| `priceInCents` | number | Yes | Price in cents (e.g., 2500 for $25.00) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Page

**Slug:** `FINGERTIP_CREATE_PAGE`

Tool to create a new page within a Fingertip site. Use when you need to add a new page to an existing site. Requires siteId, slug, and name. Returns the created page with its unique ID and timestamps.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Display name of the page. Required. |
| `slug` | string | Yes | URL-friendly path segment for the page (e.g., 'about', 'services'). Required. Must be unique within the site. |
| `siteId` | string | Yes | UUID of the site to create the page in. Required. Use FINGERTIP_LIST_SITES to get valid site IDs. |
| `position` | number | No | Display position of the page within the site. Defaults to 1 if not specified. |
| `logoMedia` | string | No | Logo media for the page. Can be null. |
| `bannerMedia` | string | No | Banner media for the page. Can be null. |
| `description` | string | No | Description of the page content. Optional. |
| `socialIcons` | string | No | Social media icons configuration. Can be null. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Page Block

**Slug:** `FINGERTIP_CREATE_PAGE_BLOCK`

Creates a new block within the specified page. Returns the created block with its unique ID and timestamps. Use when you need to add content blocks like headings, paragraphs, or images to a page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `kind` | string | No | Type or category of the block (e.g., 'heading', 'paragraph', 'image'). Can be null. |
| `name` | string | Yes | Name of the block. Required. |
| `pageId` | string | Yes | UUID of the page to create a block in. Required. |
| `content` | string | No | Content of the block. Can be null. |
| `isComponent` | boolean | No | Whether this block is a component. Defaults to false. |
| `componentBlockId` | string | No | ID of the component block if this is an instance. Can be null. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Fingertip Site

**Slug:** `FINGERTIP_CREATE_SITE`

Creates a new Fingertip site with the specified configuration. Requires name, slug (URL identifier), and businessType. Returns the created site with its unique ID and auto-generated home page. Use ENABLED status for live sites or UNPUBLISHED for drafts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Display name of the site (e.g., 'Acme Coffee Shop'). |
| `slug` | string | Yes | URL-friendly identifier for the site (lowercase, hyphens allowed). Must be unique. Example: 'acme-coffee-shop'. |
| `status` | string ("EMPTY" | "UNPUBLISHED" | "PREVIEW" | "SOFT_CLAIM" | "ENABLED" | "DEMO" | "ARCHIVED") | No | Initial status of the site. Defaults to EMPTY if not provided. Use ENABLED for live sites, UNPUBLISHED for drafts, PREVIEW for testing, DEMO for showcase. |
| `timeZone` | string | No | IANA time zone identifier for the site (e.g., 'America/New_York'). |
| `logoMedia` | string | No | Logo media object containing image URL and metadata. |
| `homePageId` | string | No | UUID of the page to use as the site's home page. If not provided, a default home page is created. |
| `locationId` | string | No | UUID of an associated location. Use to link the site to a physical address. |
| `description` | string | No | Brief description of the site for SEO and display purposes. |
| `socialIcons` | string | No | Configuration object for social media icons to display on the site. |
| `workspaceId` | string | No | UUID of the workspace this site belongs to. |
| `businessType` | string | Yes | Type of business the site represents (e.g., 'restaurant', 'cafe', 'retail', 'technology'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Site Contact

**Slug:** `FINGERTIP_CREATE_SITE_CONTACT`

Tool to create a new contact associated with a site including marketing preferences. Use when you need to add contacts to a Fingertip site with their email, personal details, and marketing consent status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address of the contact (required). |
| `notes` | string | No | Additional notes or context about the contact. |
| `phone` | string | No | Phone number of the contact. Include country code for international numbers. |
| `siteId` | string | Yes | UUID of the site to associate this contact with (required). |
| `lastName` | string | No | Last name of the contact. |
| `firstName` | string | No | First name of the contact. |
| `marketingStatus` | string ("SUBSCRIBED" | "UNSUBSCRIBED" | "CLEANED" | "PENDING" | "TRANSACTIONAL" | "ARCHIVED") | No | Marketing consent status options for a site contact. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Site Invitation

**Slug:** `FINGERTIP_CREATE_SITE_INVITATION`

Tool to create a new invitation for a user to join a site. Use when you need to invite someone to access and collaborate on a specific site with a designated role.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role` | string ("OWNER" | "EDITOR" | "VIEWER") | Yes | Role to assign to the invited user (OWNER, EDITOR, or VIEWER) |
| `email` | string | Yes | Email address of the user to invite |
| `siteId` | string | Yes | ID of the site to create an invitation for (UUID format) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Webhook Subscription

**Slug:** `FINGERTIP_CREATE_WEBHOOK`

Tool to create a webhook subscription for receiving real-time event notifications from Fingertip. Use when you need to receive notifications for events like new contacts, form responses, bookings, or orders. Returns the webhook subscription ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `triggers` | array | Yes | List of event subscriptions for this webhook. At least one trigger is required. The webhook will fire when any of these events occur. |
| `endpointUrl` | string | Yes | The destination URL that will receive webhook notifications. Must be a valid URI (https:// recommended). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Block

**Slug:** `FINGERTIP_DELETE_BLOCK`

Tool to permanently delete a block by its ID. Use when you need to remove a block after confirming it is no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `blockId` | string | Yes | ID of the block to delete (UUID format) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Draft Invoice

**Slug:** `FINGERTIP_DELETE_DRAFT_INVOICE`

Tool to delete a draft store invoice. Use when you need to remove a draft invoice that is no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoiceId` | string | Yes | UUID of the draft invoice to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Invoice Item

**Slug:** `FINGERTIP_DELETE_INVOICE_ITEM`

Tool to delete a Fingertip invoice item. Use when you need to remove an invoice item by its UUID after confirming it is no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `itemId` | string | Yes | UUID of the invoice item to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Fingertip Page

**Slug:** `FINGERTIP_DELETE_PAGE`

Tool to permanently delete a page and all associated data. Use when you need to remove a page by its UUID after confirming it is no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pageId` | string | Yes | UUID of the page to permanently delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Fingertip Site

**Slug:** `FINGERTIP_DELETE_SITE`

Tool to delete a Fingertip site. Use when you need to permanently remove a site by its UUID after confirming it is no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `siteId` | string | Yes | UUID of the site to permanently delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Site Invitation

**Slug:** `FINGERTIP_DELETE_SITE_INVITATION`

Tool to delete a site invitation by its ID. Use when you need to cancel or remove a pending site invitation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invitation_id` | string | Yes | ID of the site invitation to delete (UUID format) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Site Membership

**Slug:** `FINGERTIP_DELETE_SITE_MEMBERSHIP`

Tool to delete a specific site membership. Use when you need to remove a user from a site after confirming the membership ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `membership_id` | string | Yes | ID of the site membership to delete (UUID format) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Webhook

**Slug:** `FINGERTIP_DELETE_WEBHOOK`

Tool to remove an existing webhook subscription. Use when you need to permanently delete a webhook by its UUID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhookId` | string | Yes | UUID of the webhook subscription to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Workspace Invitation

**Slug:** `FINGERTIP_DELETE_WORKSPACE_INVITATION`

Tool to delete a workspace invitation by its ID. Use after obtaining the invitation ID to cancel a pending workspace invitation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invitation_id` | string | Yes | ID of the workspace invitation to delete (UUID format) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Block

**Slug:** `FINGERTIP_GET_BLOCK`

Tool to retrieve a specific block by its ID. Returns block details including content, metadata, and timestamps. Returns 404 if the block is not found.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `blockId` | string | Yes | UUID of the block to retrieve. Use FINGERTIP_LIST_PAGE_BLOCKS to get valid block IDs for a page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Comprehensive Site Analytics

**Slug:** `FINGERTIP_GET_COMPREHENSIVE_SITE_ANALYTICS`

Tool to retrieve comprehensive analytics for a specific site. Use when you have a site ID and need period-based breakdowns including optional store metrics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `period` | string ("7d" | "30d" | "90d" | "1y" | "all") | No | Time period for analytics data (7d, 30d, 90d, 1y, all) |
| `site_id` | string | Yes | ID of the site whose analytics to retrieve (UUID format) |
| `include_store` | boolean | No | Whether to include store analytics in the response |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Invoice Item

**Slug:** `FINGERTIP_GET_INVOICE_ITEM`

Tool to retrieve details of a specific invoice item by its ID. Use when you need to fetch information about a specific invoice item including its title, description, price, and currency.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `itemId` | string | Yes | UUID of the invoice item to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Page

**Slug:** `FINGERTIP_GET_PAGE`

Tool to retrieve a specific Fingertip page by its ID. Returns complete page details including name, slug, description, timestamps, media configurations, and theme settings. Use when you need detailed information about a specific page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pageId` | string | Yes | UUID of the page to retrieve. Use FINGERTIP_LIST_PAGES to get valid page IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Page Theme

**Slug:** `FINGERTIP_GET_PAGE_THEME`

Retrieve the theme configuration for a specific page. Use when you need to get the theme details including ID, content, and timestamps for a page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pageId` | string | Yes | UUID of the page to retrieve the theme for. Required. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Fingertip Site

**Slug:** `FINGERTIP_GET_SITE`

Tool to retrieve a specific Fingertip site by its UUID. Use when you need to fetch detailed information about a single site.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `siteId` | string | Yes | UUID of the site to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Webhook

**Slug:** `FINGERTIP_GET_WEBHOOK`

Tool to retrieve a specific webhook by ID with its related triggers. Use when you need to fetch details of a single webhook including its configuration and event subscriptions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhookId` | string | Yes | Unique identifier (UUID) of the webhook to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Health Check

**Slug:** `FINGERTIP_HEALTH_CHECK`

Tool to verify API connectivity. Use when checking API health before other operations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Fingertip Blog Posts

**Slug:** `FINGERTIP_LIST_BLOG_POSTS`

Tool to list published blog posts for a specific site. Use when you have a site ID and need to paginate, sort, and retrieve post summaries.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor for fetching next or previous pages. |
| `siteId` | string | Yes | UUID of the site to list blog posts for. |
| `sortBy` | string ("createdAt" | "updatedAt" | "publishedAt") | No | Field to sort by. One of 'createdAt', 'updatedAt', 'publishedAt'. Default is 'updatedAt'. |
| `pageSize` | integer | No | Number of items per page (default 10, max 25). |
| `sortDirection` | string ("asc" | "desc") | No | Sort direction. One of 'asc' or 'desc'. Default is 'desc'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Bookings

**Slug:** `FINGERTIP_LIST_BOOKINGS`

Tool to retrieve a paginated list of bookings for a site with optional status filtering. Use when you need to fetch bookings for a specific site, optionally filtered by booking status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response to fetch the next page. |
| `siteId` | string | Yes | UUID of the site to fetch bookings for. Required. |
| `status` | string ("CANCELLED" | "ACCEPTED" | "REJECTED" | "PENDING" | "COMPLETED" | "NO_SHOW" | "REFUNDED" | "PENDING_CONFIRMATION") | No | Booking status enumeration |
| `pageSize` | integer | No | Number of bookings per page (1-25). Default is 10, maximum is 25. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Event Types

**Slug:** `FINGERTIP_LIST_EVENT_TYPES`

Tool to list event types for a specific site. Use after confirming the siteId to retrieve a paginated list of published event types.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response. |
| `siteId` | string | Yes | UUID of the site to retrieve event types for. |
| `sortBy` | string ("createdAt" | "updatedAt" | "position") | No | Field to sort by (default 'updatedAt'). Allowed: createdAt, updatedAt, position. |
| `pageSize` | integer | No | Number of items per page (default 10, max 25). |
| `sortDirection` | string ("asc" | "desc") | No | Sort order (default 'desc'). Allowed: asc, desc. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Form Responses

**Slug:** `FINGERTIP_LIST_FORM_RESPONSES`

Tool to retrieve form responses for a specific form template and site. Use when you need to fetch form submissions after obtaining the form template ID and site ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous request |
| `siteId` | string | Yes | UUID of the site to retrieve responses for |
| `pageSize` | integer | No | Number of items per page (default 10, max 25) |
| `formTemplateId` | string | Yes | UUID of the form template to retrieve responses for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Form Templates

**Slug:** `FINGERTIP_LIST_FORM_TEMPLATES`

Tool to retrieve a paginated list of form templates. Use when you need to fetch multiple templates for a site after obtaining its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous request |
| `search` | string | No | Search query to filter form template titles |
| `siteId` | string | Yes | UUID of the site to retrieve form templates for |
| `sortBy` | string ("createdAt" | "updatedAt" | "title") | No | Field to sort by |
| `pageSize` | integer | No | Number of items per page (default 10, max 25) |
| `sortDirection` | string ("asc" | "desc") | No | Sort direction |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Invoice Items

**Slug:** `FINGERTIP_LIST_INVOICE_ITEMS`

Tool to list invoice items for a specific Fingertip site. Use when you need to retrieve billable items with pagination and optional search filtering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response to fetch the next page. |
| `search` | string | No | Search term to filter invoice items by title or description. |
| `siteId` | string | Yes | UUID of the site to list invoice items for. Required. |
| `pageSize` | integer | No | Number of items per page (default: 10, max: 25). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Fingertip Invoices

**Slug:** `FINGERTIP_LIST_INVOICES`

Tool to retrieve a paginated list of invoices for sites the user has access to. Use when you need to fetch invoices with optional filtering by status and sorting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response to fetch the next page. |
| `siteId` | string | Yes | UUID of the site to retrieve invoices for. Required. |
| `sortBy` | string ("createdAt" | "updatedAt" | "dueAt" | "invoiceNumber") | No | Sort field options for invoice listing. |
| `status` | string ("DRAFT" | "PENDING" | "VOID" | "PAID" | "UNPAID" | "REFUNDED" | "PROCESSING") | No | Invoice status filter options. |
| `pageSize` | integer | No | Number of invoices per page (default 10, max 25). |
| `sortDirection` | string ("asc" | "desc") | No | Sort direction options. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Fingertip Messages

**Slug:** `FINGERTIP_LIST_MESSAGES`

Tool to retrieve a paginated list of messages for a site. Use when you need to fetch messages for a specific site or contact.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor for fetching next or previous pages. |
| `pageSize` | integer | No | Number of items per page (default: 10, max: 25). |
| `siteSlug` | string | Yes | Site slug to filter messages for a specific site. |
| `siteContactId` | string | No | Site contact ID to filter messages for a specific contact. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Orders

**Slug:** `FINGERTIP_LIST_ORDERS`

Tool to retrieve orders with basic information for a specific site. Use when you need to fetch paginated order data by site slug.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `site` | string | Yes | Site slug to retrieve orders for. Required parameter to identify which site's orders to fetch. |
| `cursor` | string | No | Pagination cursor from a previous response (pageInfo.endCursor) to fetch the next page of results. |
| `pageSize` | integer | No | Number of orders per page (1-25). Default is 10, maximum is 25. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Page Blocks

**Slug:** `FINGERTIP_LIST_PAGE_BLOCKS`

Tool to retrieve all blocks associated with a specific page. Use when you have a page ID and need to access the page's block structure and content.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pageId` | string | Yes | UUID of the page to retrieve blocks for. Required. Use FINGERTIP_LIST_PAGES to get valid page IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Pages

**Slug:** `FINGERTIP_LIST_PAGES`

List all pages for a specific Fingertip site. Returns paginated results with page details including ID, slug, name, timestamps, and media configurations. Use cursor-based pagination to iterate through large result sets.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response (pageInfo.endCursor or pageInfo.startCursor) to fetch the next or previous page of results. |
| `siteId` | string | Yes | UUID of the site to list pages for. Required. Use FINGERTIP_LIST_SITES to get valid site IDs. |
| `sortBy` | string ("createdAt" | "updatedAt") | No | Field to sort results by. Defaults to 'updatedAt' if not specified. |
| `pageSize` | integer | No | Number of pages to return per request (1-25). Defaults to 10 if not specified. |
| `sortDirection` | string ("asc" | "desc") | No | Sort order: 'asc' for oldest first, 'desc' for newest first. Defaults to 'desc'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Page Themes

**Slug:** `FINGERTIP_LIST_PAGE_THEMES`

Tool to retrieve a paginated list of page themes. Use when you need to fetch available page themes, optionally scoped to a specific site, with pagination support.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response to fetch the next page. |
| `siteId` | string | No | Optional site UUID to scope the page themes. If omitted, fetches all page themes. |
| `pageSize` | integer | No | Number of page themes per page (1-25). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Quotes

**Slug:** `FINGERTIP_LIST_QUOTES`

List all quotes for a specific Fingertip site. Returns paginated results with quote and contact details. Use cursor-based pagination to iterate through large result sets. Supports filtering by status and contact ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response (pageInfo.endCursor or pageInfo.startCursor) to fetch the next or previous page of results. |
| `search` | string | No | Search term to filter quotes by contact name, quote number, or other searchable fields. |
| `pageSize` | integer | No | Number of quotes to return per request (1-25). Defaults to 10 if not specified. |
| `siteSlug` | string | Yes | Site slug to retrieve quotes for. Required. Use FINGERTIP_LIST_SITES to get valid site slugs. |
| `siteContactId` | string | No | Filter quotes by a specific site contact ID (UUID). |
| `statusFilters` | array | No | Filter quotes by status. Accepts an array of status values to filter by multiple statuses. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Sample Bookings

**Slug:** `FINGERTIP_LIST_SAMPLE_BOOKINGS`

Tool to retrieve sample bookings for testing and development purposes. Use when you need to access sample booking data without requiring a specific site ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response to fetch the next page |
| `pageSize` | integer | No | Number of bookings per page (1-25). Default is 10, maximum is 25. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Sample Form Responses

**Slug:** `FINGERTIP_LIST_SAMPLE_FORM_RESPONSES`

Tool to retrieve sample form responses for a specific form template. Use when you need to fetch example responses for a form by its slug.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor |
| `pageSize` | integer | No | Number of items per page (default: 10, max: 25) |
| `formTemplateSlug` | string | Yes | Slug of the form template to retrieve responses for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Sample Orders

**Slug:** `FINGERTIP_LIST_SAMPLE_ORDERS`

Tool to retrieve sample orders for testing purposes. Use when you need to access sample order data for development or testing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response to fetch the next page |
| `pageSize` | integer | No | Number of items per page (1-25). Default is 10, maximum is 25. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Sample Site Contacts

**Slug:** `FINGERTIP_LIST_SAMPLE_SITE_CONTACTS`

Tool to retrieve sample site contacts with basic information. Use when you need example contacts for testing or demonstration purposes.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Site Contacts

**Slug:** `FINGERTIP_LIST_SITE_CONTACTS`

Tool to retrieve site contacts with basic contact information and engagement metrics. Use when you need to list contacts for a specific site with optional filtering by marketing status, search terms, or contact attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response (pageInfo.endCursor) to fetch the next page of results. |
| `search` | string | No | Search term to filter contacts by name, email, or other fields. |
| `siteId` | string | Yes | UUID of the site to list contacts for. Required. Use FINGERTIP_LIST_SITES to get valid site IDs. |
| `pageSize` | integer | No | Number of contacts per page (1-25). Defaults to 10 if not specified. |
| `hasOrders` | boolean | No | Filter contacts that have placed orders. |
| `hasQuotes` | boolean | No | Filter contacts that have quotes. |
| `hasRatings` | boolean | No | Filter contacts that have ratings. |
| `hasInvoices` | boolean | No | Filter contacts that have invoices. |
| `hasPayments` | boolean | No | Filter contacts that have made payments. |
| `createdAfter` | string | No | Filter contacts created after this ISO 8601 timestamp. |
| `hasAppointments` | boolean | No | Filter contacts that have appointments. |
| `hasSegmentation` | boolean | No | Filter contacts that have segmentation data. |
| `hasFormResponses` | boolean | No | Filter contacts that have submitted form responses. |
| `marketingStatuses` | array | No | Filter contacts by marketing subscription status. Can include multiple statuses. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Site Invitations

**Slug:** `FINGERTIP_LIST_SITE_INVITATIONS`

Tool to retrieve a paginated list of invitations for a specific site. Use when you need to check pending or accepted invitations for a site.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response to fetch the next page |
| `siteId` | string | Yes | UUID of the site to retrieve invitations for |
| `pageSize` | integer | No | Number of invitations per page (1-25). Default is 10, maximum is 25. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Site Memberships

**Slug:** `FINGERTIP_LIST_SITE_MEMBERSHIPS`

Tool to retrieve a paginated list of site memberships. Use after confirming the site ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response to fetch the next page |
| `siteId` | string | Yes | UUID of the site to retrieve memberships for |
| `pageSize` | integer | No | Number of memberships per page (1-25). Default is server-defined. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Sites

**Slug:** `FINGERTIP_LIST_SITES`

Tool to retrieve a paginated list of sites accessible by the API key. Use when you need to fetch sites page by page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response to fetch the next page |
| `pageSize` | integer | No | Number of sites per page (1-25). Default is server-defined. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Webhooks

**Slug:** `FINGERTIP_LIST_WEBHOOKS`

Tool to retrieve a paginated list of webhooks with optional filtering and sorting. Use when you need to fetch webhooks page by page with customizable sort order.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response to fetch the next page. |
| `sortBy` | string ("createdAt" | "updatedAt") | No | Field to sort by. One of 'createdAt' or 'updatedAt'. Default is 'updatedAt'. |
| `pageSize` | integer | No | Number of webhooks per page (default 10, max 25). |
| `sortDirection` | string ("asc" | "desc") | No | Sort direction. One of 'asc' or 'desc'. Default is 'desc'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Workspaces

**Slug:** `FINGERTIP_LIST_WORKSPACES`

Tool to retrieve a paginated list of workspaces accessible to the API key. Use when you need to navigate through multiple workspaces.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response to fetch the next page |
| `pageSize` | integer | No | Number of items per page (1-25). Default is server-defined. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Mark Invoice as Paid

**Slug:** `FINGERTIP_MARK_INVOICE_PAID`

Tool to mark a store invoice as paid in Fingertip. Use when recording payment completion for an invoice. Requires the invoice UUID and the timestamp when payment was completed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoiceId` | string | Yes | UUID of the invoice to mark as paid |
| `completedAt` | string | Yes | ISO 8601 timestamp indicating when the payment was completed (e.g., '2026-02-14T10:00:00Z') |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Patch Page Theme

**Slug:** `FINGERTIP_PATCH_PAGE_THEME`

Apply JSON Patch operations to page theme content following RFC 6902. Use to modify theme properties like colors, fonts, and spacing without replacing the entire theme. Operations are applied sequentially and support add, remove, replace, move, copy, and test operations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pageId` | string | Yes | UUID of the page whose theme will be patched. Use FINGERTIP_LIST_PAGES to get valid page IDs. |
| `patches` | array | Yes | Array of JSON Patch operations to apply to the theme content. Operations are applied sequentially in the order provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Help Articles

**Slug:** `FINGERTIP_SEARCH_HELP_ARTICLES`

Tool to search help documentation articles by query string. Use when you need to find relevant help articles matching specific keywords or topics.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of results to return (default: 10, max: 20). |
| `search` | string | Yes | Search query string to find matching help articles. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Store Invoice

**Slug:** `FINGERTIP_SEND_INVOICE`

Tool to send a store invoice to a customer. Use when you need to deliver an invoice notification after creating or updating it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `siteSlug` | string | Yes | URL-friendly slug identifier of the site associated with this invoice (e.g., 'tech-startup-site-004') |
| `invoiceId` | string | Yes | UUID of the invoice to send to the customer |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Fingertip Quote

**Slug:** `FINGERTIP_SEND_QUOTE`

Tool to send a store quote by its UUID. Use when you need to deliver a quote to the customer after it has been prepared.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `quoteId` | string | Yes | UUID of the quote to send |
| `siteSlug` | string | Yes | Site slug identifying which site the quote belongs to |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Block

**Slug:** `FINGERTIP_UPDATE_BLOCK`

Updates an existing block with the provided data. Allows partial updates - only fields provided in the request will be updated. Returns 404 if the block is not found.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `kind` | string | No | Type or category of the block (e.g., 'heading', 'paragraph', 'image'). Provide to update the block kind. |
| `name` | string | No | Name of the block. Provide to update the block name. |
| `blockId` | string | Yes | Unique identifier (UUID) of the block to update. |
| `content` | object | No | Content of the block as a JSON object. Provide to update the block content. |
| `isComponent` | boolean | No | Whether this block is a component. Provide to update component status. |
| `componentBlockId` | string | No | ID of the component block if this is an instance (UUID). Can be set to null to remove component association. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Invoice Item

**Slug:** `FINGERTIP_UPDATE_INVOICE_ITEM`

Tool to update an invoice item in Fingertip. Use when you need to modify the title, price, or description of an existing invoice item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | No | Updated title of the invoice item |
| `itemId` | string | Yes | UUID of the invoice item to update |
| `description` | string | No | Updated description of the invoice item |
| `priceInCents` | integer | No | Updated price in cents (e.g., 2500 for $25.00) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Page

**Slug:** `FINGERTIP_UPDATE_PAGE`

Tool to update an existing Fingertip page with new data. Use when you need to modify page properties like name, description, slug, position, or media configurations. Only fields included in the request will be updated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Name of the page. Set to null to clear the name. |
| `slug` | string | No | URL-friendly path segment for the page (e.g., 'about', 'services'). |
| `pageId` | string | Yes | UUID of the page to update. Required. Use FINGERTIP_LIST_PAGES to get valid page IDs. |
| `siteId` | string | No | ID of the site this page belongs to (UUID format). Use to move the page to a different site. |
| `position` | number | No | Display position of the page within the site. Defaults to 1 if not specified. |
| `logoMedia` | string | No | Logo media for the page. Can be null to remove logo media. |
| `bannerMedia` | string | No | Banner media for the page. Can be null to remove banner media. |
| `description` | string | No | Description of the page content. Set to null to clear the description. |
| `socialIcons` | string | No | Social media icons configuration. Can be null to remove social icons. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Page Theme

**Slug:** `FINGERTIP_UPDATE_PAGE_THEME`

Tool to update the theme configuration for a specific page. Use when you need to modify theme settings such as making it a reusable component, linking it to a parent component theme, or updating theme content.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pageId` | string | Yes | ID of the page to update the theme for. |
| `content` | string | No | Theme content configuration. Can be null to clear theme content. |
| `isComponent` | boolean | No | Whether this theme is a reusable component. Defaults to false. |
| `componentPageThemeId` | string | No | ID of the parent component theme if this is an instance. Set to null if not using a component theme. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Fingertip Quote

**Slug:** `FINGERTIP_UPDATE_QUOTE`

Tool to update an existing Fingertip store quote. Use when you need to modify quote items, pricing, discounts, or metadata like memo and footer. Requires the quote ID and at least one quote item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `memo` | string | No | Internal memo or notes about the quote |
| `notes` | string | No | Additional notes or terms for the quote |
| `footer` | string | No | Footer text to display at the bottom of the quote |
| `quoteId` | string | Yes | UUID of the quote to update |
| `expiresAt` | string | No | Expiration date for the quote in ISO 8601 format (e.g., '2024-12-31T23:59:59Z') |
| `quoteItems` | array | Yes | List of items in the quote. Must provide at least one item. |
| `siteContactId` | string | No | UUID of the site contact associated with this quote |
| `quoteDiscounts` | array | No | List of discounts to apply to the quote (optional) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Fingertip Site

**Slug:** `FINGERTIP_UPDATE_SITE`

Updates an existing Fingertip site with provided partial data. Use when modifying site properties like name, description, status, or configuration. Only include fields you want to change - all fields are optional except siteId.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Display name of the site (e.g., 'Acme Coffee Shop'). |
| `slug` | string | No | URL-friendly identifier for the site (lowercase, hyphens allowed). Must be unique. |
| `siteId` | string | Yes | UUID of the site to update |
| `status` | string ("EMPTY" | "UNPUBLISHED" | "PREVIEW" | "SOFT_CLAIM" | "ENABLED" | "DEMO" | "ARCHIVED") | No | Status of the site. Use ENABLED for live sites, UNPUBLISHED for drafts, PREVIEW for testing, DEMO for showcase, ARCHIVED to deactivate. |
| `timeZone` | string | No | IANA time zone identifier for the site (e.g., 'America/New_York'). |
| `logoMedia` | string | No | Logo media object containing image URL and metadata. |
| `homePageId` | string | No | UUID of the page to use as the site's home page. |
| `locationId` | string | No | UUID of an associated location. Use to link the site to a physical address. |
| `description` | string | No | Brief description of the site for SEO and display purposes. |
| `socialIcons` | string | No | Configuration object for social media icons to display on the site. |
| `workspaceId` | string | No | UUID of the workspace this site belongs to. |
| `businessType` | string | No | Type of business the site represents (e.g., 'restaurant', 'cafe', 'retail', 'technology'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Webhook

**Slug:** `FINGERTIP_UPDATE_WEBHOOK`

Tool to update an existing Fingertip webhook subscription. Use when you need to modify the endpoint URL or change the event triggers for a webhook. Only fields included in the request will be updated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `triggers` | array | No | List of triggers for this webhook subscription. Each trigger specifies an eventType and optional inputData. At least one trigger is required if provided. |
| `webhookId` | string | Yes | UUID of the webhook to update. Required. |
| `endpointUrl` | string | No | URL that will receive webhook notifications. Must be a valid HTTPS URL. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
