Skip to content
Get API key (opens in a new tab)

company-review.submitted

Sent when a customer submits a company review, with the review, the reviewer's profile and their loyalty standing.

A company review rates your company rather than a product. Use it to route feedback about service and delivery to the team that owns it.

When it fires

  • Once per review, when a customer submits it through a Cevoid review form or widget.
  • Reviews imported through the API start no Flows, and past reviews cannot be enrolled later.
  • The review can still be waiting for moderation: check data.company_review.status before you show it anywhere.
  • profile, points and tier describe the reviewer.

Receive it

In Settings โ†’ Flows, choose Create flow โ†’ Forward event โ†’ Webhook and pick the Company review submitted trigger. See Set up a webhook.

Payload

Example payload
{
  "created_at": "2026-08-12T18:44:12.000Z",
  "data": {
    "company_review": {
      "answers": [
        {
          "format": "SINGLE_SELECT",
          "options": [
            {
              "label": "Faster than expected",
              "value": "fast"
            },
            {
              "label": "On time",
              "value": "on_time"
            },
            {
              "label": "Late",
              "value": "late"
            }
          ],
          "prompt": "How was the delivery?",
          "type": "COMPANY_ATTRIBUTE",
          "value": "fast"
        }
      ],
      "approved_at": "2026-08-12T18:44:11.000Z",
      "body": "The parcel arrived two days after I ordered.",
      "channel": "REQUEST",
      "created_at": "2026-08-12T18:43:30.000Z",
      "helpful_down_count": 0,
      "helpful_up_count": 0,
      "id": "crv_5h2n8q4w1k7mza",
      "identity_verification": "CONFIRMED",
      "is_incentivized": false,
      "is_insider": false,
      "language": "en",
      "market_id": "mar_s3k8w1n5q2x7ye",
      "media": [],
      "order_id": "ord_7k2m4n8p5x9qwe",
      "profile_id": "prf_c4n8x2q1m5v7rt",
      "published_at": "2026-08-12T18:44:11.000Z",
      "purchase_verification": "VERIFIED",
      "rating": 4,
      "rejection_reasons": [],
      "responses": [],
      "status": "PUBLISHED",
      "submitted_at": "2026-08-12T18:44:10.000Z",
      "title": "Fast delivery",
      "updated_at": "2026-08-12T18:44:11.000Z"
    },
    "points": {
      "expiring_30d": 0,
      "expiring_60d": 200,
      "expiring_90d": 200,
      "lifetime_earned": 3870,
      "lifetime_spent": 2450,
      "next_expiration_at": "2026-09-30T23:59:59.999Z",
      "pending": 130,
      "spendable": 1290,
      "total": 1420
    },
    "profile": {
      "country": "SE",
      "created_at": "2026-03-14T08:12:44.000Z",
      "email": "astrid.lindqvist@example.com",
      "external_id": "7391056823401",
      "first_name": "Astrid",
      "id": "prf_c4n8x2q1m5v7rt",
      "language": "sv",
      "last_name": "Lindqvist",
      "name": "Astrid Lindqvist",
      "name_display_format": "FIRST_LAST_INITIAL",
      "updated_at": "2026-08-03T11:58:02.000Z"
    },
    "tier": {
      "current_tier": {
        "expires_at": "2026-12-31T23:59:59.999Z",
        "id": "tier_0m3v8k2q9x1sdf",
        "name": "Silver"
      },
      "next_tier": {
        "entry_rewards": [
          {
            "title": "15% off your next order",
            "type": "DISCOUNT_CODE"
          }
        ],
        "id": "tier_5p7w2n4k8c1zyh",
        "milestones": [
          {
            "current": 1420,
            "percent_complete": 71,
            "remaining": 580,
            "required": 2000,
            "type": "POINTS"
          }
        ],
        "name": "Gold",
        "perks": [
          {
            "value": "Free shipping on every order"
          }
        ]
      }
    }
  },
  "id": "2b4d6f8a-0c1e-83a5-97b9-c1d3e5f7a9b0",
  "origin": {
    "flow": {
      "id": "wfl_4k7w1q9m3x5ndz",
      "name": "Sync company reviews to CRM"
    }
  },
  "type": "company-review.submitted",
  "version": 1
}
Show all 117 linesShow fewer lines
typestringrequired

The event type, always company-review.submitted.

idstring<uuid>required

Unique event ID, the same value as the webhook-id header. Retries keep it; a replay gets a new one.

created_atstring<date-time>required

When the delivery was scheduled to send, in ISO 8601 UTC: for a Flow, when its webhook action ran, after any Wait step. Retries and replays keep it.

versionintegerrequired

Payload version, currently 1.

originobject

Why this destination received the event. Absent when no Flow sent it.

origin properties
flowobjectrequired

The Flow that sent the event.

flow properties
idstringrequired

Flow ID.

namestringrequired

Flow name at the time of the delivery.

dataobjectrequired

The company review and its reviewer.

data properties
company_reviewobject

The company review.

company_review properties
idstringrequired

Cevoid company review ID.

ratingintegerrequired

Score from 1 to 5.

titlestring

Reviewer-supplied headline. In localized responses, title and body both use source text unless a complete translation is available.

bodystring

Reviewer-supplied text. Absent for star-only reviews. In localized responses, title and body both use source text unless a complete translation is available.

languagestringrequired

BCP-47 language of the original submission, even when the returned text is translated.

statusstringrequired

Moderation and conversion state. One of PENDING, PUBLISHED, REJECTED, CONVERTED.

rejection_reasonsstring[]required

Policy reasons recorded when moderation rejected the review. Empty unless status is REJECTED; a single take-down can carry several. Each item is one of SPAM, FAKE, DUPLICATE, OFF_TOPIC, PROFANE, ILLEGAL, PII.

identity_verificationstringrequired

Author verification state. Public display requires CONFIRMED. One of PENDING, CONFIRMED, EXPIRED.

purchase_verificationstringrequired

Purchase evidence state behind verified-buyer display. One of VERIFIED, UNVERIFIED.

is_incentivizedbooleanrequired

Whether a reward influenced submission.

is_insiderbooleanrequired

Whether the reviewer is brand-connected.

channelstringrequired

How the review entered Cevoid. One of REQUEST, WIDGET, LINK, IMPORT, SYNDICATED_IN.

sourceobject

External provenance. Present for imported or syndicated reviews.

source properties
platformstringrequired

Source-system slug, such as okendo or yotpo.

external_idstring

Review identifier in the source system.

urlstring

Link to the review in its source system.

profile_idstringrequired

Cevoid public identifier of the reviewer.

market_idstring

Cevoid public market identifier.

order_idstring

Cevoid public identifier of the matched order.

reward_idstring

Granted reward, when the review was incentivized.

converted_from_idstring

Review this one was converted from.

converted_to_idstring

Replacement review created by conversion.

mediaobject[]required
media[] properties
typestringrequired

Whether the item is an image or a video. One of IMAGE, VIDEO.

urlstringrequired

Delivery URL for the full asset.

thumbnail_urlstringrequired

Delivery URL for the thumbnail.

aspect_rationumberrequired

Width divided by height.

aspect_ratio_typestringrequired

Coarse orientation bucket. One of LANDSCAPE, PORTRAIT, SQUARE.

video_lengthnumber

Video duration in seconds.

moderation_statusstring

Moderation state for this asset, independent from the review itself. One of PENDING, APPROVED, DECLINED.

responsesobject[]required

Public workspace replies. Private replies are never exposed.

responses[] properties
bodystringrequired

Reply text as published.

author_typestringrequired

Whether the workspace or a named team member authored the reply. One of WORKSPACE, TEAM_MEMBER.

created_atstring<date-time>required

ISO 8601 timestamp when the reply was created.

updated_atstring<date-time>

ISO 8601 timestamp when the reply was last edited.

helpful_up_countnumberrequired

Positive helpful votes from shoppers.

helpful_down_countnumberrequired

Negative helpful votes, when down-voting is enabled.

submitted_atstring<date-time>

ISO 8601 timestamp when submission completed.

approved_atstring<date-time>

ISO 8601 timestamp when moderation approved it.

published_atstring<date-time>

ISO 8601 timestamp when it first became public.

created_atstring<date-time>required

ISO 8601 timestamp when Cevoid created the review.

updated_atstring<date-time>required

ISO 8601 timestamp when Cevoid last updated the review.

answersobject[]required
answers[] properties
typestringrequired

What the question was about. One of COMPANY_ATTRIBUTE, PROFILE_PROPERTY.

promptstringrequired

Question wording as shown at submission time.

formatstringrequired

Input shape used to interpret value. One of SCALE, CENTERED_RANGE, SINGLE_SELECT, MULTI_SELECT, WOULD_RECOMMEND, NUMERIC.

optionsobject[]

Options as shown at submission time.

options[] properties
valuestringrequired
labelstringrequired
scaleobject

Scale definition as shown at submission time.

scale properties
stepsnumberrequired
start_labelstringrequired
end_labelstringrequired
center_labelstring
step_labelsstring[]
valuenumber | string | boolean | string[]required

Submitted scalar or selection, interpreted per format.

profileobject

The profile of the reviewer. Absent when no profile is linked.

profile properties
idstringrequired

Cevoid profile ID.

external_idstring

Identifier this profile carries in the workspace source system, when known.

namestring

Display name of the profile.

first_namestring

First name of the profile.

last_namestring

Last name of the profile.

emailstring

Email address for the profile.

avatar_urlstring

Profile image URL.

countrystring

Country code associated with the profile.

languagestring

Preferred language code associated with the profile.

locationstring

Free-form location associated with the profile.

social_instagram_handlestring

Instagram handle associated with the profile.

social_tiktok_handlestring

TikTok handle associated with the profile.

social_x_handlestring

X handle associated with the profile.

birthdaystring<date>

Birthday in YYYY-MM-DD format.

name_display_formatstring

Preferred format for displaying the profile name. One of FULL, FIRST_LAST_INITIAL, FIRST, ANONYMOUS.

biostring

Profile biography text.

notesstring

Internal notes about the profile.

created_atstring<date-time>required

ISO 8601 timestamp when the profile was created.

updated_atstring<date-time>required

ISO 8601 timestamp when the profile was last updated.

pointsobject

The profile's loyalty points. Only for workspaces with Loyalty, and only when the profile is a member.

points properties
totalnumberrequired

Total active and pending points.

spendablenumberrequired

Active points available to spend.

pendingnumberrequired

Earned points not active yet.

expiring_30dnumberrequired

Points expiring within 30 days.

expiring_60dnumberrequired

Points expiring within 60 days.

expiring_90dnumberrequired

Points expiring within 90 days.

lifetime_earnednumberrequired

Points earned over the membership lifetime.

lifetime_spentnumberrequired

Points spent over the membership lifetime.

next_expiration_atstring<date-time>

Earliest upcoming active-points expiration.

tierobject

The profile's tier standing. Only for workspaces with Loyalty, and only when the profile is a member.

tier properties
current_tierobject | nullrequired

The member's current tier; null without one.

current_tier properties
idstringrequired

Cevoid tier ID.

namestringrequired

Display name of the tier.

icon_urlstring

Optional icon representing the tier.

expires_atstring<date-time>

When the current tier expires, if tier evaluations expire.

next_tierobject | nullrequired

The next tier the member can reach; null when there is none.

next_tier properties
idstringrequired

Cevoid tier ID.

namestringrequired

Display name of the tier.

icon_urlstring

Optional icon representing the tier.

milestonesobject[]required

Progress required for the next tier.

milestones[] properties
typestringrequired

Metric used to qualify for the next tier. One of POINTS, AMOUNT_SPENT, NUMBER_OF_PURCHASES.

requirednumberrequired

Required amount for the next tier. AMOUNT_SPENT values use major currency units.

currentnumberrequired

Current progress. AMOUNT_SPENT values use major currency units.

remainingnumberrequired

Remaining amount. AMOUNT_SPENT values use major currency units.

percent_completenumberrequired

Progress percentage, capped at 100.

entry_rewardsobject[]required

Rewards granted at the next tier.

entry_rewards[] properties
typestringrequired

Reward type granted when the tier is reached.

titlestringrequired

Human-readable reward title.

icon_urlstring

Optional icon representing the reward.

perksobject[]required

Perks associated with the next tier.

perks[] properties
valuestringrequired

Human-readable perk text.