# 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
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `GATHERUP`
- **Version:** 20260211_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. **Prerequisites**: - Valid businessId (from search/get business endpoints) - ClientId and privateKey (from GatherUp Account Owner > Client Details) - Valid hash signature (generate using GATHERUP_GENERATE_HASH_SIGNATURE) **Important**: Verify the businessId before deletion. Check errorCode in response: 0=success, non-zero=error.

### Generate GatherUp Hash Signature

**Slug:** `GATHERUP_GENERATE_HASH_SIGNATURE`

Tool to generate a SHA-256 hash signature required by GatherUp endpoints. Signature rule (commonly documented by GatherUp): SHA-256 over: privateKey + concatenation of all request parameter key-value pairs (excluding 'hash'), ordered alphabetically by key. Include clientId when present.

### 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: 1. Use GATHERUP_GENERATE_HASH_SIGNATURE to create the required hash signature 2. Use GATHERUP_SEARCH_BUSINESS if you need to find a businessId by customField/extraField Authentication: Requires valid clientId and hash signature generated from your GatherUp privateKey.

### 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) Prerequisites: Generate hash signature first using GATHERUP_GENERATE_HASH_SIGNATURE action.

### 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. Requires valid GatherUp API credentials (clientId and hash). Prerequisites: 1. Obtain your clientId from GatherUp dashboard (Account Owner > Client Details) 2. Use GATHERUP_GENERATE_HASH_SIGNATURE action to generate the required hash signature 3. Have a valid customerId for an existing customer in your GatherUp account 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, 1=invalid hash, 2=invalid clientId, 3=server error, 44=customer not found Endpoint: POST https://app.gatherup.com/api/customer/get

### 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. It's essential for workflows where you need to find a business ID based on external identifiers from your system (e.g., CRM IDs, store numbers, location codes). Prerequisites: - Valid GatherUp clientId (from Account Owner > Client Details) - Hash signature (generate via GATHERUP_GENERATE_HASH_SIGNATURE action) - The business must have the customField or extraField value set in GatherUp Returns the businessId on success (errorCode=0), or an error code with message on failure. Common error codes: 1=Invalid hash, 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. Before using this tool: 1. Use GATHERUP_GENERATE_HASH_SIGNATURE to create the hash parameter with your clientId, customerId, and other params 2. Ensure the customer exists in your GatherUp account 3. Verify the customer hasn't unsubscribed from feedback requests Use this when you want to automatically request feedback after a customer interaction or transaction.
