Documentation

Gorgias Create CSAT Survey

This action creates a Customer Satisfaction (CSAT) survey for a specified Gorgias ticket. It provides a way to programmatically add CSAT surveys to tickets for collecting customer feedback.

A CSAT survey allows you to collect customer satisfaction feedback for a ticket. Each ticket can only have one survey associated with it. The action will verify the ticket exists and has a valid customer before creating the survey.

The survey must have a score between 1-5, and you can optionally specify when it was completed. If no completion time is provided, the current time will be used.

Action Inputs

NameTypeDescription
DomainCredentialsYour Gorgias sub-domain
UserCredentialsYour Gorgias username for authentication
KeyCredentialsYour Gorgias API key for authentication
Ticket IDStringThe ID of the ticket to create the survey for
CSAT ScoreStringSatisfaction score (must be between 1-5)
Scored DateTimeOptional StringWhen the survey was filled out. Can be Unix timestamp (e.g. "1731110545.5844529") or ISO string (e.g. "2024-11-08T19:02:25.584434-05:00"). Current time used if not provided

Action Outputs

NameTypeDescription
SuccessBooleanWhether the survey was created successfully
Survey IDStringThe ID of the newly created survey

Error Handling

The action will return success: false if:

  • A survey already exists for the ticket
  • The ticket doesn't have an associated customer
  • The CSAT score is invalid (not 1-5)
  • Rate limit is exceeded
  • Any API or authentication errors occur