Specific

These are the Specific actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

• Create Company

  Tool to create a new company record in the Specific platform. Use when you need to add a new company to the workspace with optional ID, name, and custom attributes.

• Create Conversation

  Tool to create a new conversation (survey response) in the Specific platform. Use when you need to add a new conversation with content, optional contacts, companies, and custom fields. Content can be a simple string or structured ProseMirror document with headings and paragraphs.

• Create or Update Company

  Tool to upsert a company record in the Specific platform (create if not exists, update if exists). Use when you need to ensure a company exists with specific data, creating or updating as necessary based on the filter criteria.

• Create Or Update User

  Tool to upsert a user record in the Specific platform (creates if not exists, updates if exists). Use when you need to ensure a contact exists with specific data, merging with existing records based on email or ID.

• Create User

  Tool to create a new user (contact) record in the Specific platform. Use when you need to add a new contact with email, name, and optional custom attributes or company association.

• Delete User

  Tool to remove a user record from the Specific platform. Use when you need to permanently delete a contact from the workspace.

• Get My Workspace

  Tool to get current workspace information for the authenticated user. Use when you need to retrieve the workspace ID and name for the authenticated API key.

• List Companies

  Tool to query company records from the Specific platform via GraphQL. Use when you need to retrieve company information, optionally filtering by ID or name.

• List Conversations

  Tool to query conversation records (survey responses) from the Specific platform via GraphQL. Use when you need to retrieve customer feedback, survey responses, or conversation history. Returns up to 20 most recent conversations, optionally filtered by source identifiers.

• List Custom Fields

  Tool to query custom field definitions in the Specific platform. Use when you need to retrieve available custom fields that can be associated with companies, contacts, or conversations. Optionally filter by entity type.

• List Sources

  Tool to retrieve all data sources from the Specific platform. Use when you need to fetch available sources in the workspace.

• List Surveys

  Tool to retrieve multiple survey records from the Specific platform via GraphQL. Use when you need to fetch all available surveys with their metadata, including names, contexts, tones, and associated conversation data.

• List Users

  Tool to query user accounts from the Specific platform via GraphQL. Use when you need to retrieve user information, optionally filtering by ID, email, or custom attributes.

• Update User

  Tool to modify an existing user record in the Specific platform via GraphQL mutation. Use when you need to update contact information such as name, email, company association, or custom attributes.

• Delete Company

  Tool to delete a company record from the Specific platform. Use when you need to remove a company by its ID. The operation is permanent and returns the deleted company's details.

• Delete Company Attributes

  Tool to delete specific custom field attributes from a company record. Use when you need to remove custom attributes by their keys from a company. Returns the updated company details.

• Delete User Attributes

  Tool to delete specific custom field attributes from a user record in the Specific platform. Use when you need to remove custom field values from a contact without deleting the contact itself.

• Update Company

  Tool to update an existing company record in the Specific platform. Use when modifying company name or custom attributes.