# company-review-request.created

> Sent when a Flow's Company review request action sends to a webhook, with the link to the review form and one link per star rating.

Breadcrumb: Webhooks › company-review-request.created · Status: Flow only · Updated: 2026-11-04
Docs index: https://docs.cevoid.com/developers/llms.txt

Use it to send company review requests through your own email or SMS tool instead of Cevoid's.

## When it fires

- Each time a Flow's _Company review request_ action runs with a webhook as its delivery target.
- `data.subject` is the order or product review that started the request, as its `type` and `id`.
- `data.review_link` opens the review form. `data.rating_links` has the same link for each star rating from `1` to `5`, with its `rating` parameter set to that number.

## Receive it

In a Flow on _Order fulfilled_, _Order delivered_ or _Product review submitted_, add the _Company review request_ action, set _Delivery target_ to Webhook and choose your destination. See [Send from a Flow](https://docs.cevoid.com/developers/webhooks/set-up.md#send-from-a-flow).

## Payload

```json title="Example payload"
{
  "created_at": "2026-11-02T09:30:00.000Z",
  "data": {
    "profile": {
      "avatar_url": "https://cdn.cevoid.com/avatars/prf_sarah/profile.jpg",
      "bio": "Lifestyle creator and photography enthusiast",
      "birthday": "1992-04-18",
      "country": "US",
      "created_at": "2026-01-15T09:30:00.000Z",
      "email": "sarah.johnson@example.com",
      "external_id": "customer_7391056823401",
      "first_name": "Sarah",
      "id": "prf_sarah",
      "language": "en",
      "last_name": "Johnson",
      "location": "San Francisco, CA",
      "name": "Sarah Johnson",
      "notes": "VIP customer; prefers email communication",
      "social_instagram_handle": "sarah.lifestyle",
      "social_tiktok_handle": "sarah.creates",
      "social_x_handle": "sarah_j",
      "updated_at": "2026-01-20T14:22:15.000Z"
    },
    "rating_links": {
      "1": {
        "full_url": "https://shop.example.com/pages/reviews?cevoid.widget=reviews.company-review&cevoid.auth=example-signed-token&rating=1",
        "query_string": "?cevoid.widget=reviews.company-review&cevoid.auth=example-signed-token&rating=1",
        "search_params": {
          "cevoid.auth": "example-signed-token",
          "cevoid.widget": "reviews.company-review",
          "rating": "1"
        }
      },
      "2": {
        "full_url": "https://shop.example.com/pages/reviews?cevoid.widget=reviews.company-review&cevoid.auth=example-signed-token&rating=2",
        "query_string": "?cevoid.widget=reviews.company-review&cevoid.auth=example-signed-token&rating=2",
        "search_params": {
          "cevoid.auth": "example-signed-token",
          "cevoid.widget": "reviews.company-review",
          "rating": "2"
        }
      },
      "3": {
        "full_url": "https://shop.example.com/pages/reviews?cevoid.widget=reviews.company-review&cevoid.auth=example-signed-token&rating=3",
        "query_string": "?cevoid.widget=reviews.company-review&cevoid.auth=example-signed-token&rating=3",
        "search_params": {
          "cevoid.auth": "example-signed-token",
          "cevoid.widget": "reviews.company-review",
          "rating": "3"
        }
      },
      "4": {
        "full_url": "https://shop.example.com/pages/reviews?cevoid.widget=reviews.company-review&cevoid.auth=example-signed-token&rating=4",
        "query_string": "?cevoid.widget=reviews.company-review&cevoid.auth=example-signed-token&rating=4",
        "search_params": {
          "cevoid.auth": "example-signed-token",
          "cevoid.widget": "reviews.company-review",
          "rating": "4"
        }
      },
      "5": {
        "full_url": "https://shop.example.com/pages/reviews?cevoid.widget=reviews.company-review&cevoid.auth=example-signed-token&rating=5",
        "query_string": "?cevoid.widget=reviews.company-review&cevoid.auth=example-signed-token&rating=5",
        "search_params": {
          "cevoid.auth": "example-signed-token",
          "cevoid.widget": "reviews.company-review",
          "rating": "5"
        }
      }
    },
    "review_link": {
      "full_url": "https://shop.example.com/pages/reviews?cevoid.widget=reviews.company-review&cevoid.auth=example-signed-token",
      "query_string": "?cevoid.widget=reviews.company-review&cevoid.auth=example-signed-token",
      "search_params": {
        "cevoid.auth": "example-signed-token",
        "cevoid.widget": "reviews.company-review"
      }
    },
    "subject": {
      "id": "ord_abc123",
      "type": "order"
    }
  },
  "id": "evt_m3p82kdq5xw7tz4c",
  "origin": {
    "flow": {
      "id": "wfl_q7v2m9x4k8d3h6b5",
      "name": "Post-purchase follow-up"
    },
    "trigger": "order.fulfilled"
  },
  "type": "company-review-request.created",
  "version": 1
}
```

- `version` (`number`, required): The version of this event type. A published version only gains fields, so ignore fields you do not use; a breaking change is a new version.
- `id` (`string`, required): Stable event id (`evt_` plus 16 characters), also sent as the `webhook-id` header. Retries and manual replays send the same id, so ignore an event whose id you have already processed.
- `type` (`string`, required): What `data` describes. New types are added over time, and an endpoint on "All events" receives them, so ignore any type you do not handle.
- `created_at` (`string<date-time>`, required): When the event happened, as an ISO 8601 timestamp.
- `origin` (`object`): Why your endpoint received the event. Omitted when the event was forwarded without a Flow of your own.
  - `origin.flow` (`object`, required): The Flow that sent the event.
    - `origin.flow.id` (`string`, required): The Flow id, shown in the Flow URL.
    - `origin.flow.name` (`string`, required): The Flow name at the time of sending.
  - `origin.trigger` (`string`, required): The event that started the Flow. One of `order.fulfilled`, `order.delivered`, `product-review.submitted`, `company-review.submitted`, `product-review.replied`, `company-review.replied`, `upload.completed`, `post.approved`, `profile.program-joined`, `profile.program-left`, `tier.earned`, `reward.fulfilled`, `tier.evaluation-approaching`, `points.expiration-approaching`.
- `data` (`object`, required): The resources the event carries, keyed by resource name. `type` decides which resources are included, and resources your plan does not include are left out.
  - `data.profile` (`object`)
    - `data.profile.id` (`string`, required): Cevoid profile ID.
    - `data.profile.external_id` (`string`): Identifier this profile carries in the workspace source system, when known.
    - `data.profile.name` (`string`): Display name of the profile.
    - `data.profile.first_name` (`string`): First name of the profile.
    - `data.profile.last_name` (`string`): Last name of the profile.
    - `data.profile.email` (`string`): Email address for the profile.
    - `data.profile.avatar_url` (`string`): Profile image URL.
    - `data.profile.country` (`string`): Country code associated with the profile.
    - `data.profile.language` (`string`): Preferred language code associated with the profile.
    - `data.profile.location` (`string`): Free-form location associated with the profile.
    - `data.profile.social_instagram_handle` (`string`): Instagram handle associated with the profile.
    - `data.profile.social_tiktok_handle` (`string`): TikTok handle associated with the profile.
    - `data.profile.social_x_handle` (`string`): X handle associated with the profile.
    - `data.profile.birthday` (`string<date>`): Birthday in YYYY-MM-DD format.
    - `data.profile.bio` (`string`): Profile biography text.
    - `data.profile.notes` (`string`): Merchant notes about the profile.
    - `data.profile.created_at` (`string<date-time>`, required): ISO 8601 timestamp when the profile was created.
    - `data.profile.updated_at` (`string<date-time>`, required): ISO 8601 timestamp when the profile was last updated.
  - `data.subject` (`object`, required)
  - `data.review_link` (`object`, required)
    - `data.review_link.full_url` (`string<uri>`, required)
    - `data.review_link.query_string` (`string`, required)
    - `data.review_link.search_params` (`object`, required)
  - `data.rating_links` (`object`, required)
    - `data.rating_links.1` (`object`, required)
      - `data.rating_links.1.full_url` (`string<uri>`, required)
      - `data.rating_links.1.query_string` (`string`, required)
      - `data.rating_links.1.search_params` (`object`, required)
    - `data.rating_links.2` (`object`, required)
      - `data.rating_links.2.full_url` (`string<uri>`, required)
      - `data.rating_links.2.query_string` (`string`, required)
      - `data.rating_links.2.search_params` (`object`, required)
    - `data.rating_links.3` (`object`, required)
      - `data.rating_links.3.full_url` (`string<uri>`, required)
      - `data.rating_links.3.query_string` (`string`, required)
      - `data.rating_links.3.search_params` (`object`, required)
    - `data.rating_links.4` (`object`, required)
      - `data.rating_links.4.full_url` (`string<uri>`, required)
      - `data.rating_links.4.query_string` (`string`, required)
      - `data.rating_links.4.search_params` (`object`, required)
    - `data.rating_links.5` (`object`, required)
      - `data.rating_links.5.full_url` (`string<uri>`, required)
      - `data.rating_links.5.query_string` (`string`, required)
      - `data.rating_links.5.search_params` (`object`, required)

## Related articles

- [product-review-request.created](https://docs.cevoid.com/developers/webhooks/product-review-request-created.md) (Flow only)
- [company-review.submitted](https://docs.cevoid.com/developers/webhooks/company-review-submitted.md)
- [Event types](https://docs.cevoid.com/developers/webhooks/event-types.md)

---

Canonical: https://docs.cevoid.com/developers/webhooks/company-review-request-created
