API documentation

GET /text_message_flows/:id

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/text_message_flows/:id

Get SMS Flow by id.

Returns a single SMS Flow by id, including its matching pattern and response configuration.

Example Request

curl 'https://[your-subdomain].trackdrive.com/api/v1/text_message_flows/a6af7847-1b1e-4760-ac0d-e1813a6d3a09' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "text_message_flow": {
    "id": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "type": "TextMessageFlow",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": null,
    "routes_edit_path": "/text_message_flows/a6af7847-1b1e-4760-ac0d-e1813a6d3a09/edit",
    "external_record_id": null,
    "name": "Quote Request SMS",
    "context_menu_name": "Quote Request SMS",
    "company_id": 10001,
    "user_id": null,
    "sortable_order": -5,
    "description": "Quote Request SMS",
    "offer_id": 10002,
    "parse_value_with_expression": null,
    "value_formatter": null,
    "value_expression": null,
    "use_flow_when_pattern_matches": null,
    "record_token_filter_id": null,
    "token_value_ids": null,
    "request_a_response": true,
    "response_message": "Your quote is ready! Reply VIEW to receive the details.",
    "contact_field_assign_id": null,
    "contact_field_validate_id": null,
    "text_message_flow_id": null,
    "assert_acceptable_with_contact_field": null,
    "response_message_when_unacceptable": null,
    "record_token_additional_id": null,
    "attribution_token_value_ids": null,
    "outgoing_webhook_ids": [],
    "text_message_flows_count": 0,
    "process_response_with_sms_flow_type": null,
    "wait_for_response_seconds": 7200,
    "valid_responses_csv": null,
    "record_token_filter_data_count": 0,
    "record_token_filter_data": [],
    "record_token_additional_data_count": 0,
    "record_token_additional_data": []
  },
  "metadata": {
    "root": "text_message_flow"
  }
}