Skip to main content
GHL MCP Guide
SSB

Survey Submissions

Workflows & Surveys · Intermediate · Updated March 2026

Retrieve survey submission data with individual responses, timestamps, and contact associations for analytics and CRM workflow integration.

Survey Submissions gives you programmatic access to the actual response data collected through GHL surveys. Every form fill, every multi-step survey completion, every piece of data your prospects and clients submit — accessible through a single endpoint.

What This MCP Tool Does

This tool retrieves all submissions for a specific survey, including individual field responses, submission timestamps, and the associated contact record. This is the data layer that lets you build reporting dashboards, sync survey responses to external systems, or analyze patterns in how leads respond to qualification questions.

Endpoint Reference

Get submissions for a survey: GET /surveys/{surveyId}/submissions Returns all submissions for the specified survey with response data, timestamps, and contact associations.

Authentication

Requires a Private Integration Token (PIT) with the surveys scope enabled.

Key Parameters

The response includes for each submission:

  • id — unique submission identifier
  • contactId — the GHL contact associated with this submission
  • responses — object containing field-value pairs for each answered question
  • createdAt — timestamp of when the submission was received

Use the survey ID from the Survey Manager tool to target a specific survey.

Important Notes

Submissions are tied to the survey they came from. To get all survey data across a sub-account, you need to first list all surveys and then retrieve submissions for each one individually.

Submissions link back to contact records through the contactId field. This means you can correlate survey responses with contact behavior, pipeline stage, tags, and other CRM data by cross-referencing with the Contact CRUD tool.

For high-volume surveys, submissions may be paginated. Implement pagination handling in your integration to ensure you capture all responses.

Common Questions

Can I filter submissions by date range? Check the endpoint parameters for date filtering support. If not available at the API level, retrieve all submissions and filter client-side by the createdAt timestamp.

How do I match a submission to a specific contact? Each submission includes a contactId field. Use this with the Contact CRUD tool to pull the full contact record and see the complete picture of who submitted what.

Can I delete or modify submissions through the API? No. Submission data is read-only through the API. Modifications to survey data need to happen in the GHL UI or by updating the associated contact record directly.

How do I build a reporting dashboard from survey data? Pull submissions programmatically on a schedule, extract the response fields, and push the data to your reporting tool (Metabase, Google Sheets, a custom dashboard). The structured response format makes this straightforward to parse and aggregate.

Back to GHL MCP Guide