# Gatherup

GatherUp is a customer feedback and online review management platform that helps businesses collect, manage, and leverage customer feedback to improve their online reputation.

- **Category:** reviews
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 9
- **Triggers:** 0
- **Slug:** `GATHERUP`
- **Version:** 20260429_00

## Tools

### Delete GatherUp Business

**Slug:** `GATHERUP_DELETE_BUSINESS`

Permanently deletes a business location from GatherUp. This is a destructive operation that cannot be undone. **When to use**: Remove business locations that are no longer needed or were created in error. **Important**: Verify the businessId before deletion. Check errorCode in response: 0=success, non-zero=error.

### Find GatherUp Agency Client ID

**Slug:** `GATHERUP_FIND_AGENCY_CLIENT_ID`

Find the client ID for a specific business in GatherUp agency accounts. This tool retrieves the numeric client identifier associated with a business location. Use this when you need to look up the client ID for agency-level operations or business management.

### Get GatherUp Business

**Slug:** `GATHERUP_GET_BUSINESS`

Retrieve detailed information about a specific GatherUp business location. Returns comprehensive business data including: name, contact details (phone, address), timezone, business type, subscription package, communication settings, engagement metrics (NPS score, feedback counts), and marketing assets (logos, banners, feedback URLs). Prerequisites: - Use GATHERUP_SEARCH_BUSINESS if you need to find a businessId by customField/extraField

### Get GatherUp Business Types

**Slug:** `GATHERUP_GET_BUSINESS_TYPES`

Retrieves the list of available business categories from GatherUp (e.g., Restaurant, Hotel, Dental Office). Use this to: - Get valid business type IDs for creating new businesses - Discover available business categories in GatherUp - Filter business types by search term (optional)

### Get GatherUp Customer

**Slug:** `GATHERUP_GET_CUSTOMER`

Retrieves detailed information about a specific customer from GatherUp by their customer ID. Use this action to get customer details including name, email, phone, rating, feedback status, and other customer-related information. Common use cases: - Retrieve customer contact information before sending feedback requests - Check customer's current rating and feedback status - Verify customer subscription status (unsubscribed flag) - Get customer creation date and associated business details Error codes: 0=success, 2=invalid clientId, 3=server error, 44=customer not found Endpoint: POST https://app.gatherup.com/api/customer/get

### Get Widget HTML

**Slug:** `GATHERUP_GET_WIDGET_HTML`

Retrieve pre-formatted widget or badge HTML code with schema.org structure and SEO-friendly content. Returns ready-to-embed HTML code that displays customer reviews or badges on your website. The HTML includes structured data markup for better search engine visibility. Prerequisites: - Use GATHERUP_SEARCH_BUSINESS if you need to find a businessId

### Search GatherUp Business by Custom Identifier

**Slug:** `GATHERUP_SEARCH_BUSINESS`

Search for a GatherUp business location by custom identifier and retrieve its business ID. This tool locates business locations using user-defined identifiers (customField or extraField) that you've assigned in GatherUp. Returns the businessId on success (errorCode=0), or an error code with message on failure. Common error codes: 2=Invalid clientId, 25=Business not found, 26=Invalid search type Endpoint: POST /api/business/search

### Send GatherUp Customer Feedback

**Slug:** `GATHERUP_SEND_CUSTOMER_FEEDBACK`

Send a feedback request to a customer to collect their rating and review. Use this when you want to automatically request feedback after a customer interaction or transaction. Ensure the customer exists in your GatherUp account and hasn't unsubscribed from feedback requests.

### Set GatherUp User Password

**Slug:** `GATHERUP_SET_USER_PASSWORD`

Sets a new password for an existing user in GatherUp. Use this action to update user credentials securely. **Prerequisites**: - Valid userId (user must exist in your GatherUp account) - Password must meet security requirements: minimum 12 characters, at least one uppercase letter and one number **When to use**: Update user passwords for security purposes or user account management. Check errorCode in response: 0=success, non-zero=error. See errorMessage for details.
