feed.video.received

​

Webhook Type

​

Payload Format

{
  "type": "feed.video.received",
  "data": {
    "project": {
      "logo": "LOGO_URL",
      "name": "PROJECT_NAME",
      "description": "PROJECT_DESCRIPTION"
    },
    "feed_form": {
      "id": "FORM_SLUG",
      "url": "FORM_URL",
      "logo": "FORM_LOGO_URL",
      "name": "FORM_NAME"
    },
    "feed_id": "FEED_ID",
    "feed_url": "FEED_URL",
    "thumbnail_url": "THUMBNAIL_IMAGE_URL",
    "video_url": "VIDEO_FILE_URL",
    "video_extension": "mp4",
    "video_size": 1048576,
    "response": {
      "name": "RESPONDER_NAME",
      "email": "RESPONDER_EMAIL",
      "consent": true,
      "position": "RESPONDER_POSITION",
      "organization_name": "RESPONDER_ORGANIZATION_NAME",
      "contact_number": "RESPONDER_PHONE_NUMBER",
      "photo": "RESPONDER_PHOTO_URL",
      "company_logo": "RESPONDER_COMPANY_LOGO_URL",
      "company_url": "RESPONDER_COMPANY_URL",
      "other_text": "ANSWER_TO_CUSTOM_FIELD",
      "other_text2": "ANSWER_TO_CUSTOM_FIELD_2",
      "other_text3": "ANSWER_TO_CUSTOM_FIELD_3",
      "type": "Video",
      "comment": "REVIEW_COMMENT",
      "rating": "5"
    },
    "favourite": false,
    "created_at": "TIMESTAMP",
    "updated_at": "TIMESTAMP",
    "live_mode": true
  },
  "reviewer_email": "RESPONDER_EMAIL"
}

​

Object Structure

​

Project Object

{
  "logo": "LOGO_URL",
  "name": "PROJECT_NAME",
  "description": "PROJECT_DESCRIPTION"
}

​

Project Fields

• logo: URL to the project’s logo image
• name: Name of the project/workspace
• description: Description or identifier for the project

​

Feed Form Object

{
  "id": "FORM_SLUG",
  "url": "FORM_URL",
  "logo": "FORM_LOGO_URL",
  "name": "FORM_NAME"
}

​

Feed Form Fields

• id: The form’s public slug, the same identifier that appears in the form’s public URL. This is not the unique_form_id used by the Review Forms API, so it cannot be passed to those endpoints.
• url: Public URL where the form can be accessed
• logo: URL to the form’s page image. Only present when the form has a page image configured, so treat it as optional.
• name: Name or title of the review form

​

Response Object

{
  "name": "RESPONDER_NAME",
  "email": "RESPONDER_EMAIL",
  "consent": true,
  "position": "RESPONDER_POSITION",
  "organization_name": "RESPONDER_ORGANIZATION_NAME",
  "contact_number": "PHONE_NUMBER",
  "photo": "PHOTO_URL",
  "company_logo": "COMPANY_LOGO_URL",
  "company_url": "COMPANY_URL",
  "other_text": "ANSWER_TO_CUSTOM_FIELD",
  "other_text2": "ANSWER_TO_CUSTOM_FIELD_2",
  "other_text3": "ANSWER_TO_CUSTOM_FIELD_3",
  "type": "Video",
  "comment": "REVIEW_COMMENT",
  "rating": "5"
}

​

Fields

• name: Name of the person who submitted the review
• email: Email address of the reviewer
• consent: Whether the reviewer gave consent to share their information
• position: Position or role of the reviewer
• organization_name: Name of the organization of the reviewer
• contact_number: Phone number of the reviewer
• photo: URL to the reviewer’s photo
• company_logo: URL to the reviewer’s company logo
• company_url: Website URL of the reviewer’s company
• other_text: Answer of the custom field added by the Feedspace user in the feed form settings
• other_text2: Answer of the second custom field, when the form defines one
• other_text3: Answer of the third custom field, when the form defines one
• type: How the video was captured ("Video", "Screen" or "Upload")
• comment: The written review text submitted alongside the video, null when none was given
• rating: The star rating as a string, e.g. "5" or "4.5", and null when the form did not collect a rating

​

Top-Level Fields

{
  "feed_id": "FEED_ID",
  "feed_url": "FEED_URL",
  "thumbnail_url": "THUMBNAIL_IMAGE_URL",
  "video_url": "VIDEO_FILE_URL",
  "video_extension": "mp4",
  "video_size": 1048576,
  "favourite": false,
  "created_at": "TIMESTAMP",
  "updated_at": "TIMESTAMP",
  "live_mode": true
}

​

Top-Level Field Descriptions

• feed_id: Unique identifier for this specific review
• feed_url: Public URL where the review is accessible
• thumbnail_url: URL to the video thumbnail image. When no thumbnail was generated this is an empty string "", not null.
• video_url: URL to access the video file
• video_extension: File extension of the video (e.g., mp4)
• video_size: Size of the video file in bytes, as an integer
• favourite: Whether this review is marked as favorite
• created_at: Timestamp when the review was created
• updated_at: Timestamp when the review was last updated
• live_mode: Whether this is a live mode (true) or test mode (false)