---
canonical_url: "https://docs.composio.dev/toolkits/judge_me"
markdown_url: "https://docs.composio.dev/toolkits/judge_me.md"
product: "platform"
version: null
last_updated: null
---

# Judge.me

Judge.me helps online stores collect, manage, and display product and shop reviews.

- **Category:** reviews
- **Auth:** OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 34
- **Triggers:** 0
- **Slug:** `JUDGE_ME`
- **Version:** 00000000_00

## Tools

### Bulk Create Webhooks

**Slug:** `JUDGE_ME_BULK_CREATE_WEBHOOKS`

Create multiple webhook subscriptions in one request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhooks` | array | Yes | Webhook subscriptions to create in one request. |

#### 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 |

### Bulk Update Review Visibility

**Slug:** `JUDGE_ME_BULK_UPDATE_REVIEW_VISIBILITY`

Sequentially publish, hide, archive, or unarchive 1-25 reviews. Each update uses a separate request, and the response reports a per-item outcome so one rejected update does not hide partial completion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `updates` | array | Yes | One to 25 review visibility updates to process in order. Each item must set curated or hidden so the batch cannot report a no-op as successful. |

#### 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 |

### Count Reviews

**Slug:** `JUDGE_ME_COUNT_REVIEWS`

Count management review records, optionally filtered by reviewer, product, and star rating. Use the storefront aggregate count action for widget-facing all-review or shop-review totals.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rating` | integer ("1" | "2" | "3" | "4" | "5") | No | Only count reviews with this star rating. |
| `product_id` | integer | No | Judge.me internal product ID to count reviews for. |
| `reviewer_id` | integer | No | Judge.me internal reviewer ID to count reviews 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 |

### Count Storefront Reviews

**Slug:** `JUDGE_ME_COUNT_STOREFRONT_REVIEWS`

Return the storefront aggregate review count for either all product and shop-level reviews or only shop-level reviews.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `review_scope` | string ("all" | "shop") | Yes | Whether to count all product and shop-level reviews or only shop-level reviews. |

#### 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 Checkout Comment

**Slug:** `JUDGE_ME_CREATE_CHECKOUT_COMMENT`

Persist a customer's comment for a product through Judge.me's documented Checkout Comments operation. Requires the shop's Checkout Comments app entitlement.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `content` | string | No | Checkout comment content to persist. |
| `customer` | object | No | Customer associated with the checkout comment. |
| `create_from` | string ("checkout_page" | "email") | No | Source from which the checkout comment was created. |
| `external_product_id` | integer | No | External commerce-platform ID of the product. |

#### 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 Private Review Reply

**Slug:** `JUDGE_ME_CREATE_PRIVATE_REPLY`

Create a private reply to a review and, by default, email it to the reviewer.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `review_id` | integer | Yes | Judge.me internal ID of the review whose reviewer receives the private reply. |
| `email_body` | string | Yes | Body of the private reply email. |
| `email_subject` | string | Yes | Subject of the private reply email. |
| `send_private_email` | boolean | No | Whether Judge.me sends the private reply by email to the reviewer. Defaults to true and causes an external email side effect. |

#### 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 Public Review Reply

**Slug:** `JUDGE_ME_CREATE_PUBLIC_REPLY`

Post a public reply to a review and optionally email it to the reviewer. Email sending defaults to enabled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `content` | string | Yes | Public reply text. |
| `review_id` | integer | Yes | Judge.me internal ID of the review to reply to. |
| `send_reply_email` | boolean | No | Whether Judge.me also emails the public reply to the reviewer. Defaults to true; set false to post without sending email. |

#### 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 Review

**Slug:** `JUDGE_ME_CREATE_REVIEW`

Submit a public web review in the background; no review is created when the shop disables web reviews.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | Yes | Review text. |
| `title` | string | No | Optional review title. |
| `rating` | integer ("1" | "2" | "3" | "4" | "5") | Yes | Star rating from 1 to 5. |
| `platform` | string ("shopify" | "woocommerce" | "bigcommerce") | Yes | Commerce platform used by the shop. |
| `shop_domain` | string | Yes | Domain of the shop receiving the review. |
| `picture_urls` | array | No | Public URLs of pictures attached to the review. |
| `reviewer_name` | string | Yes | Public name of the reviewer. |
| `reviewer_email` | string | Yes | Email address of the reviewer. |
| `custom_form_answers` | array | No | Custom-form answers for the review. |
| `product_external_id` | integer | No | External product ID; omit to create a shop-level review. |
| `reviewer_ip_address` | string | No | Reviewer IP address used for location; omit to let Judge.me use the caller IP. |
| `reviewer_name_format` | string ("" | "last_initial" | "all_initials" | "anonymous") | No | How the reviewer prefers their name displayed publicly. |

#### 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

**Slug:** `JUDGE_ME_CREATE_WEBHOOK`

Create one webhook subscription for a Judge.me event and callback URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event` | string ("widget/settings/updated" | "widget/review_widget/updated" | "widget/preview_badge/updated" | "widget/all_reviews_count/updated" | "widget/all_reviews_rating/updated" | "widget/shop_reviews_count/updated" | "widget/shop_reviews_rating/updated" | "widget/verified_badge/updated" | "widget/all_reviews_page/updated" | "widget/featured_carousel/updated" | "widget/reviews_tab/updated" | "widget/html_miracle/updated" | "widget/product_comment/updated" | "review/created" | "review/updated" | "review/created_fail") | Yes | Judge.me event key that triggers the webhook. |
| `callback_url` | string | Yes | URL that receives Judge.me webhook POST requests. |

#### 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:** `JUDGE_ME_DELETE_WEBHOOK`

Delete the webhook subscription matching its current Judge.me event key and callback URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event` | string ("widget/settings/updated" | "widget/review_widget/updated" | "widget/preview_badge/updated" | "widget/all_reviews_count/updated" | "widget/all_reviews_rating/updated" | "widget/shop_reviews_count/updated" | "widget/shop_reviews_rating/updated" | "widget/verified_badge/updated" | "widget/all_reviews_page/updated" | "widget/featured_carousel/updated" | "widget/reviews_tab/updated" | "widget/html_miracle/updated" | "widget/product_comment/updated" | "review/created" | "review/updated" | "review/created_fail") | Yes | Current Judge.me event key of the webhook to delete. |
| `callback_url` | string | Yes | Current callback URL of the webhook 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 |

### Get All Reviews Page Widget

**Slug:** `JUDGE_ME_GET_ALL_REVIEWS_PAGE_WIDGET`

Return rendered HTML for one page of the shop's all-reviews page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Review page to render. |
| `review_type` | string ("product-reviews" | "shop-reviews") | No | Whether to render product reviews or shop-level reviews. |

#### 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 Checkout Comments Widget

**Slug:** `JUDGE_ME_GET_CHECKOUT_COMMENTS_WIDGET`

Return rendered Checkout Comments widget HTML for one product; requires the Checkout Comments app.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `product_id` | integer | No | Judge.me internal product ID; provide exactly one product selector. |
| `product_handle` | string | No | Product handle; provide exactly one product selector. |
| `product_external_id` | integer | No | External commerce-platform product ID; provide exactly one product selector. |

#### 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 Current Shop

**Slug:** `JUDGE_ME_GET_CURRENT_SHOP`

Return identity, plan, platform, owner, and widget metadata for the OAuth-connected shop.

#### 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 Featured Reviews Carousel

**Slug:** `JUDGE_ME_GET_FEATURED_REVIEWS_CAROUSEL`

Return the rendered HTML for the shop's featured-reviews carousel.

#### 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 Product

**Slug:** `JUDGE_ME_GET_PRODUCT`

Return a product by Judge.me internal ID, external commerce-platform ID, or product handle.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `handle` | string | No | Product handle. Provide exactly one product selector. |
| `product_id` | integer | No | Judge.me internal product ID. Provide exactly one product selector. |
| `external_id` | integer | No | External commerce-platform product ID. Provide exactly one product selector. |

#### 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 Product Preview Badge

**Slug:** `JUDGE_ME_GET_PRODUCT_PREVIEW_BADGE`

Return the rendered rating-and-review-count badge HTML for one product.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `product_id` | integer | No | Judge.me internal product ID; provide exactly one product selector. |
| `product_handle` | string | No | Product handle; provide exactly one product selector. |
| `product_external_id` | integer | No | External commerce-platform product ID; provide exactly one product selector. |

#### 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 Product Review Widget

**Slug:** `JUDGE_ME_GET_PRODUCT_REVIEW_WIDGET`

Return the rendered review-widget HTML for one product and, optionally, one review page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Review page rendered inside the widget. |
| `per_page` | integer | No | Maximum reviews rendered in the widget page. |
| `product_id` | integer | No | Judge.me internal product ID; provide exactly one product selector. |
| `product_handle` | string | No | Product handle; provide exactly one product selector. |
| `product_external_id` | integer | No | External commerce-platform product ID; provide exactly one product selector. |

#### 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 Review

**Slug:** `JUDGE_ME_GET_REVIEW`

Return one review by its Judge.me internal ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `review_id` | integer | Yes | Judge.me internal review ID. |

#### 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 Reviewer

**Slug:** `JUDGE_ME_GET_REVIEWER`

Return a reviewer by Judge.me internal ID, external commerce-platform ID, or email address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Reviewer email address. Provide exactly one reviewer selector. |
| `external_id` | integer | No | External commerce-platform reviewer ID. Provide exactly one reviewer selector. |
| `reviewer_id` | integer | No | Judge.me internal reviewer ID. Provide exactly one reviewer selector. |

#### 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 Reviews Rating

**Slug:** `JUDGE_ME_GET_REVIEWS_RATING`

Return the average rating for all product and shop-level reviews or for shop-level reviews only.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `review_scope` | string ("all" | "shop") | Yes | Review set to average: all includes product and shop-level reviews; shop includes only shop-level reviews. |

#### 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 Reviews Tab Widget

**Slug:** `JUDGE_ME_GET_REVIEWS_TAB_WIDGET`

Return the rendered floating reviews-tab HTML for a selected review type and page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Review page rendered in the tab. |
| `per_page` | integer | No | Maximum reviews rendered in the tab page. |
| `review_type` | string ("product-reviews" | "shop-reviews") | No | Whether to render product reviews or shop-level reviews. |

#### 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 Settings

**Slug:** `JUDGE_ME_GET_SETTINGS`

Return values for one or more named Judge.me shop settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `setting_keys` | array | Yes | One to 100 Judge.me setting keys 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 Verified Reviews Badge

**Slug:** `JUDGE_ME_GET_VERIFIED_REVIEWS_BADGE`

Return the rendered verified-review-count badge, or null when the shop has fewer than 20 verified reviews.

#### 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:** `JUDGE_ME_GET_WEBHOOK`

Return one webhook subscription by its Judge.me internal ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | integer | Yes | Judge.me internal webhook ID. |

#### 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 Widget Placeholder HTML

**Slug:** `JUDGE_ME_GET_WIDGET_PLACEHOLDER_HTML`

Return the rendered placeholder HTML used before Judge.me widget JavaScript and CSS load.

#### 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 Widget Settings HTML

**Slug:** `JUDGE_ME_GET_WIDGET_SETTINGS_HTML`

Return the shop's rendered widget customization script and style HTML, not structured setting values.

#### 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 Reviews

**Slug:** `JUDGE_ME_LIST_REVIEWS`

Return one page of reviews, optionally filtered by reviewer, product, rating, published-only state, or reviewer email. Full pages can yield a continuation whose final page is empty because Judge.me returns no total count.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rating` | integer ("1" | "2" | "3" | "4" | "5") | No | Only return reviews with this star rating. |
| `per_page` | integer | No | Maximum reviews to return in this page (1-100). |
| `published` | boolean | No | Set true to return only storefront-published reviews. Omit to return reviews regardless of publication state; Judge.me does not honor false as an unpublished-only filter. |
| `product_id` | integer | No | Judge.me internal product ID to filter by. An ID outside this shop may fall back to all shop reviews. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call; omit for the first page. |
| `reviewer_id` | integer | No | Judge.me internal reviewer ID to filter by. |
| `reviewer_email` | string | No | Only return reviews from this reviewer email address. |

#### 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:** `JUDGE_ME_LIST_WEBHOOKS`

Return all webhook subscriptions configured for the connected shop.

#### 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 |

### Request Reviewer Data

**Slug:** `JUDGE_ME_REQUEST_REVIEWER_DATA`

Submit a reviewer data request for a customer email and one or more external order IDs. The submitted privacy workflow cannot be undone.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `customer_email` | string | Yes | Customer email whose data is requested. |
| `external_order_ids` | array | Yes | External order IDs to include in the data request. |

#### 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 |

### Uninstall Shop

**Slug:** `JUDGE_ME_UNINSTALL_SHOP`

WARNING: This uninstalls Judge.me from the OAuth-connected shop and must only be called intentionally.

#### 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 Current Shop

**Slug:** `JUDGE_ME_UPDATE_CURRENT_SHOP`

Update selected profile and commerce metadata for the OAuth-connected shop. Use only with values intended to replace current shop data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Replacement shop display name. |
| `plan` | string | No | Replacement Judge.me plan value. Only send this when explicitly authorized to manage plan metadata. |
| `email` | string | No | Replacement shop contact email. |
| `owner` | string | No | Replacement shop owner name. |
| `phone` | string | No | Replacement shop phone number. |
| `domain` | string | No | Replacement platform shop domain. |
| `country` | string | No | Replacement two-letter shop country code. |
| `timezone` | string | No | Replacement shop timezone in Judge.me's accepted display format. |
| `custom_domain` | string | No | Replacement custom storefront domain. |

#### 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 Review Visibility

**Slug:** `JUDGE_ME_UPDATE_REVIEW_VISIBILITY`

Publish, hide, archive, or unarchive a review. Review text cannot be edited through this action.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `hidden` | boolean | No | Whether to archive the review. true also hides it; publishing a review also unarchives it. |
| `curated` | string ("ok" | "spam") | No | Set to ok to publish the review or spam to hide it. |
| `review_id` | integer | Yes | Judge.me internal review ID. |

#### 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:** `JUDGE_ME_UPDATE_WEBHOOK`

Replace a webhook subscription's event key and callback URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `event` | string ("widget/settings/updated" | "widget/review_widget/updated" | "widget/preview_badge/updated" | "widget/all_reviews_count/updated" | "widget/all_reviews_rating/updated" | "widget/shop_reviews_count/updated" | "widget/shop_reviews_rating/updated" | "widget/verified_badge/updated" | "widget/all_reviews_page/updated" | "widget/featured_carousel/updated" | "widget/reviews_tab/updated" | "widget/html_miracle/updated" | "widget/product_comment/updated" | "review/created" | "review/updated" | "review/created_fail") | Yes | Replacement Judge.me event key. |
| `webhook_id` | integer | Yes | Judge.me internal ID of the webhook to update. |
| `callback_url` | string | Yes | Replacement callback URL that receives webhook requests. |

#### 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 or Update Reviewer

**Slug:** `JUDGE_ME_UPSERT_REVIEWER`

Create or update a reviewer selected by Judge.me ID, external commerce ID, or email.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Reviewer name. |
| `tags` | array | No | Reviewer tags. Judge.me stores these as a comma-separated value. |
| `email` | string | Yes | Reviewer email address. |
| `phone` | string | No | Reviewer phone number. |
| `external_id` | integer | No | External commerce-platform reviewer ID used to locate or create the reviewer. |
| `reviewer_id` | integer | No | Judge.me internal reviewer ID for an existing reviewer. |
| `unsubscribed_at` | string | No | ISO 8601 timestamp when the reviewer unsubscribed from marketing. |
| `accepts_marketing` | boolean | No | Whether the reviewer accepts marketing messages. |

#### 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 |