# Schema Reference

163 schemas generated from Flownally API 1.0.0.

## Schemas

- [Response](/reference/schemas/inboxes-response.md) - object - Connected inboxes for the workspace.
- [Inbox](/reference/schemas/inbox.md) - object - A connected customer communication channel in Flownally.
- [InboxStatus](/reference/schemas/inbox-status.md) - object - Channel-agnostic operational health for an inbox.
- [InboxStatusState](/reference/schemas/inbox-status-state.md) - enum - Overall operational health of an inbox.
- [InboxStatusReason](/reference/schemas/inbox-status-reason.md) - enum - Reason an inbox is not fully active.
- [ProblemDetails](/reference/schemas/problem-details.md) - object - RFC 9457 Problem Details response with a stable Flownally error code.
- [FieldViolation](/reference/schemas/field-violation.md) - object
- [Window](/reference/schemas/messaging-window.md) - object - Tells a client whether the current actor can send in this conversation right now.
- [CreateInboxRequest](/reference/schemas/create-inbox-request.md) - object - Connect exactly one channel type per request.
- [CreateWhatsAppInboxRequest](/reference/schemas/create-whats-app-inbox-request.md) - object - Create a WhatsApp inbox
- [WhatsAppInboxRequest](/reference/schemas/whats-app-inbox-request.md) - object - WhatsApp Business resources to connect.
- [CreateMessengerInboxRequest](/reference/schemas/create-messenger-inbox-request.md) - object - Create a Messenger inbox
- [MessengerInboxRequest](/reference/schemas/messenger-inbox-request.md) - object - Facebook Pages to connect for Messenger conversations.
- [CreateInstagramInboxRequest](/reference/schemas/create-instagram-inbox-request.md) - object - Create an Instagram inbox
- [InstagramInboxRequest](/reference/schemas/instagram-inbox-request.md) - object - Instagram Business accounts to connect.
- [CreateTextInboxRequest](/reference/schemas/create-text-inbox-request.md) - object - Create a Text (LiveChat) agent inbox
- [TextInboxRequest](/reference/schemas/text-inbox-request.md) - object - LiveChat Text organization to connect.
- [CreateInboxResponse](/reference/schemas/create-inbox-response.md) - object - Inboxes created from the connected channel resources.
- [SetInboxTeamRequest](/reference/schemas/set-inbox-team-request.md) - object - Team that should own new conversations arriving in this inbox.
- [WhatsAppTemplatesResponse](/reference/schemas/whats-app-templates-response.md) - object - WhatsApp templates available for outbound template messages.
- [WhatsAppTemplate](/reference/schemas/whats-app-template.md) - object - WhatsApp message template synced from Meta.
- [WhatsAppTemplateComponent](/reference/schemas/whats-app-template-component.md) - object
- [WhatsAppTemplateButton](/reference/schemas/whats-app-template-button.md) - object
- [WABAPhoneNumbersResponse](/reference/schemas/waba-phone-numbers-response.md) - object - Phone numbers available on a WhatsApp Business Account.
- [WABAPhoneNumber](/reference/schemas/waba-phone-number.md) - object - WhatsApp phone number that can be connected to an inbox.
- [Response](/reference/schemas/users-response.md) - object - Workspace members.
- [User](/reference/schemas/user.md) - object - Person who can work in the Flownally workspace.
- [UpdateProfileRequest](/reference/schemas/update-profile-request.md) - object - Profile fields to update for the authenticated user.
- [UnreadCountResponse](/reference/schemas/unread-count-response.md) - object
- [UnreadSummaryResponse](/reference/schemas/unread-summary-response.md) - object
- [UpdateUserRoleRequest](/reference/schemas/update-user-role-request.md) - object - Role assignment for a workspace member.
- [ListTeamsResponse](/reference/schemas/list-teams-response.md) - object - Paginated teams in the workspace.
- [Team](/reference/schemas/team.md) - object - Group of teammates that can own inboxes and conversations.
- [CreateTeamRequest](/reference/schemas/create-team-request.md) - object - Team to create.
- [UpdateTeamRequest](/reference/schemas/update-team-request.md) - object
- [ListTeamAgentsResponse](/reference/schemas/list-team-agents-response.md) - object
- [UserAssignment](/reference/schemas/user-assignment.md) - object - Membership link between a user and a team.
- [AddAgentToTeamRequest](/reference/schemas/add-agent-to-team-request.md) - object - User to add to the team.
- [CreateMessageRequest](/reference/schemas/create-message-request.md) - object - Body for sending the first message or continuing a conversation by recipient.
- [MessageRecipient](/reference/schemas/message-recipient.md) - object - Choose how Flownally should find the customer thread: an existing conversation,
a known contact, or a channel recipient for first-message sends.
- [ConversationRecipient](/reference/schemas/conversation-recipient.md) - object - Continue a known conversation.
- [ContactRecipient](/reference/schemas/contact-recipient.md) - object - Send to a contact identity. Pass channel when the contact has more than one route.
- [MessageRecipientChannel](/reference/schemas/message-recipient-channel.md) - enum
- [ChannelRecipient](/reference/schemas/channel-recipient.md) - object - Start a conversation with a channel-specific recipient identifier.
- [MessageContent](/reference/schemas/message-content.md) - object - Message body to send or display. Use `text` for plain replies, `media` for uploaded
or hosted files, `template` for WhatsApp-approved templates, and `richMessage` for
interactive channel content.
- [TextMessageContent](/reference/schemas/text-message-content.md) - object - Plain text message content.
- [TextContent](/reference/schemas/text-content.md) - object - Plain text body.
- [MessageContent](/reference/schemas/media-message-content.md) - object - Media message content. Upload with `/media/uploads` first, then pass the returned `mediaId`.
- [Content](/reference/schemas/media-content.md) - object - Media reference and optional presentation details. Use `mediaId` from `POST /media/uploads`
for Flownally-hosted media. Use `url` only for externally hosted media or an existing
Flownally media handle.
- [TemplateMessageContent](/reference/schemas/template-message-content.md) - object - WhatsApp template message content. The gateway maps this to the channel-specific send internally.
- [WhatsAppTemplateContent](/reference/schemas/whats-app-template-content.md) - object
- [TemplateComponent](/reference/schemas/template-component.md) - object
- [TemplateParameter](/reference/schemas/template-parameter.md) - object
- [Parameter](/reference/schemas/media-parameter.md) - object
- [CurrencyParameter](/reference/schemas/currency-parameter.md) - object
- [DateTimeParameter](/reference/schemas/date-time-parameter.md) - object
- [RichMessageContent](/reference/schemas/rich-message-content.md) - object - Structured rich message content for channels that support cards or actions.
- [RichMessage](/reference/schemas/rich-message.md) - object
- [Card](/reference/schemas/card.md) - object
- [CardHeader](/reference/schemas/card-header.md) - object
- [CardBody](/reference/schemas/card-body.md) - object
- [CardFooter](/reference/schemas/card-footer.md) - object
- [CardAction](/reference/schemas/card-action.md) - object
- [SendMessageResponse](/reference/schemas/send-message-response.md) - object - Returned after Flownally accepts a message for delivery.
- [Message](/reference/schemas/message.md) - object - Message record with content, delivery state, and channel delivery context.
- [Reaction](/reference/schemas/reaction.md) - object
- [Conversation](/reference/schemas/conversation.md) - object - A customer conversation as it appears in the shared Flownally inbox.
- [GetMessageResponse](/reference/schemas/get-message-response.md) - object - Message status and conversation context for polling integrations.
- [CreateMediaUploadRequest](/reference/schemas/create-media-upload-request.md) - object - Multipart upload body containing the media file to send later.
- [UploadResponse](/reference/schemas/media-upload-response.md) - object - Uploaded media reference for message content.
- [ListConversationsResponse](/reference/schemas/list-conversations-response.md) - object
- [ConversationDetail](/reference/schemas/conversation-detail.md) - object
- [ListMessagesResponse](/reference/schemas/list-messages-response.md) - object
- [SendMessageRequest](/reference/schemas/send-message-request.md) - object - Body for replying inside an existing conversation.
- [SendReactionRequest](/reference/schemas/send-reaction-request.md) - object
- [SendReactionResponse](/reference/schemas/send-reaction-response.md) - object
- [ReassignConversationRequest](/reference/schemas/reassign-conversation-request.md) - object
- [MarkConversationReadRequest](/reference/schemas/mark-conversation-read-request.md) - object
- [Response](/reference/schemas/contacts-response.md) - object - Paginated contact list.
- [Contact](/reference/schemas/contact.md) - object - Customer profile used across messaging, events, and journeys.
- [Identity](/reference/schemas/identity.md) - object - Channel identity that links a contact to conversations.
- [CreateContactRequest](/reference/schemas/create-contact-request.md) - object - Contact fields to create. Add custom fields after defining them in Flownally.
- [CountResponse](/reference/schemas/contacts-count-response.md) - object
- [UpdateContactRequest](/reference/schemas/update-contact-request.md) - object
- [ImportContactsResponse](/reference/schemas/import-contacts-response.md) - object - Accepted contact import job.
- [ImportStatus](/reference/schemas/import-status.md) - object - Progress and results for a contact import.
- [ImportError](/reference/schemas/import-error.md) - object
- [SetContactCustomFieldValueRequest](/reference/schemas/set-contact-custom-field-value-request.md) - object - Value to store on a contact. Send an empty string to clear the value.
- [TagsResponse](/reference/schemas/tags-response.md) - object
- [Tag](/reference/schemas/tag.md) - object - Label used to segment and organize contacts.
- [CreateTagRequest](/reference/schemas/create-tag-request.md) - object - Tag to create.
- [CustomFieldDefinitionsResponse](/reference/schemas/custom-field-definitions-response.md) - object - Reusable custom field definitions for one resource type.
- [CustomFieldDefinition](/reference/schemas/custom-field-definition.md) - object - Defines a reusable custom field for either contacts or property records. Values are stored
separately on each resource.
- [CreateCustomFieldDefinitionRequest](/reference/schemas/create-custom-field-definition-request.md) - object - Field definition to create for the resource collection in the URL.
- [UpdateCustomFieldDefinitionRequest](/reference/schemas/update-custom-field-definition-request.md) - object - New name and value type for an existing field definition.
- [Response](/reference/schemas/journeys-response.md) - object
- [Journey](/reference/schemas/journey.md) - object - Event-driven workflow that moves contacts through follow-up steps.
- [JourneyStatus](/reference/schemas/journey-status.md) - enum
- [WorkflowDefinition](/reference/schemas/workflow-definition.md) - object
- [WorkflowNode](/reference/schemas/workflow-node.md) - object
- [StartWorkflowNode](/reference/schemas/start-workflow-node.md) - object
- [StartNodeData](/reference/schemas/start-node-data.md) - object - Journey start block settings. The backend persists these as journey triggerConfig and entryMode.
- [TriggerConfig](/reference/schemas/trigger-config.md) - object
- [EntryMode](/reference/schemas/entry-mode.md) - enum - Controls how contacts can re-enter the journey
- [WebhookWorkflowNode](/reference/schemas/webhook-workflow-node.md) - object
- [WebhookNodeData](/reference/schemas/webhook-node-data.md) - object
- [GenericWorkflowNode](/reference/schemas/generic-workflow-node.md) - object
- [GenericNodeData](/reference/schemas/generic-node-data.md) - object - Node-specific data for journey nodes without a dedicated public schema yet.
- [WorkflowEdge](/reference/schemas/workflow-edge.md) - WorkflowEdge
- [WorkflowEdge](/reference/schemas/workflow-edge2.md) - object
- [JourneyVersion](/reference/schemas/journey-version.md) - object
- [CreateJourneyRequest](/reference/schemas/create-journey-request.md) - object - Journey draft to create.
- [UpdateJourneyRequest](/reference/schemas/update-journey-request.md) - object - Journey draft fields to update.
- [JourneyVersionsResponse](/reference/schemas/journey-versions-response.md) - object
- [Response](/reference/schemas/chatbots-response.md) - object
- [Chatbot](/reference/schemas/chatbot.md) - object - Automated chat flow that can serve selected teams or the whole workspace.
- [ChatbotStatus](/reference/schemas/chatbot-status.md) - enum
- [ChatbotWorkflowDefinition](/reference/schemas/chatbots-workflow-definition.md) - object
- [ChatbotWorkflowNode](/reference/schemas/chatbots-workflow-node.md) - object
- [ChatbotVersion](/reference/schemas/chatbot-version.md) - object
- [CreateChatbotRequest](/reference/schemas/create-chatbot-request.md) - object - Chatbot draft to create.
- [UpdateChatbotRequest](/reference/schemas/update-chatbot-request.md) - object - Chatbot draft fields to update.
- [ChatbotVersionsResponse](/reference/schemas/chatbot-versions-response.md) - object
- [EventTypesResponse](/reference/schemas/event-types-response.md) - object - Event type catalog.
- [EventType](/reference/schemas/event-type.md) - object - Event definition used to validate and classify recorded customer moments.
- [CreateEventTypeRequest](/reference/schemas/create-event-type-request.md) - object - Event type to add to the workspace catalog.
- [UpdateEventTypeRequest](/reference/schemas/update-event-type-request.md) - object
- [Response](/reference/schemas/events-response.md) - object - Paginated recorded events.
- [Event](/reference/schemas/event.md) - object - Customer event stored on a contact timeline.
- [CreateEventRequest](/reference/schemas/create-event-request.md) - object - Deprecated event creation body that includes contact ID in the payload.
- [CreateContactEventRequest](/reference/schemas/create-contact-event-request.md) - object - Event to record for the contact in the path.
- [StatusResponse](/reference/schemas/billing-status-response.md) - object - Current subscription state for the workspace.
- [ListServiceAccountsResponse](/reference/schemas/list-service-accounts-response.md) - object
- [ServiceAccount](/reference/schemas/service-account.md) - object - Server-to-server integration identity.
- [CreateServiceAccountRequest](/reference/schemas/create-service-account-request.md) - object - Integration identity to create.
- [ListAPIKeysResponse](/reference/schemas/list-api-keys-response.md) - object - API keys for a service account.
- [APIKeyInfo](/reference/schemas/api-key-info.md) - object - API key metadata. The plaintext key is only returned when the key is created.
- [CreateAPIKeyRequest](/reference/schemas/create-api-key-request.md) - object - API key to create for the service account.
- [CreateAPIKeyResponse](/reference/schemas/create-api-key-response.md) - object - API key creation response. The `key` value is shown once.
- [WebhookSettings](/reference/schemas/webhook-settings.md) - object - Single tenant-level webhook configuration.
- [WebhookEventType](/reference/schemas/webhook-event-type.md) - enum
- [UpdateWebhookSettingsRequest](/reference/schemas/update-webhook-settings-request.md) - object
- [VerifyWebhookRequest](/reference/schemas/verify-webhook-request.md) - object
- [VerifyWebhookResponse](/reference/schemas/verify-webhook-response.md) - object
- [WebhookEventName](/reference/schemas/webhook-event-name.md) - string - Webhook event name. Resource webhooks use documented event types; journey and chatbot webhook blocks can use tenant-defined names.
- [WebhookAttemptStatus](/reference/schemas/webhook-attempt-status.md) - enum
- [ListWebhookAttemptsResponse](/reference/schemas/list-webhook-attempts-response.md) - object
- [WebhookAttempt](/reference/schemas/webhook-attempt.md) - object
- [ListWebhookSigningKeysResponse](/reference/schemas/list-webhook-signing-keys-response.md) - object
- [WebhookSigningKey](/reference/schemas/webhook-signing-key.md) - object
- [RotateWebhookSigningKeyResponse](/reference/schemas/rotate-webhook-signing-key-response.md) - object
- [WebhookPayload](/reference/schemas/webhook-payload.md) - object - Signed webhook event body. Deduplicate deliveries by id, which matches the webhook-id header.
- [ContactCreatedWebhookEvent](/reference/schemas/contact-created-webhook-event.md) - object
- [ContactWebhookEventData](/reference/schemas/contact-webhook-event-data.md) - object - Contact resource snapshot associated with a contact webhook event.
- [ContactUpdatedWebhookEvent](/reference/schemas/contact-updated-webhook-event.md) - object
- [ContactArchivedWebhookEvent](/reference/schemas/contact-archived-webhook-event.md) - object
- [ConversationStartedWebhookEvent](/reference/schemas/conversation-started-webhook-event.md) - object
- [ConversationWebhookEventData](/reference/schemas/conversation-webhook-event-data.md) - object - Conversation facade snapshot and related public resources.
- [ConversationUpdatedWebhookEvent](/reference/schemas/conversation-updated-webhook-event.md) - object
- [ConversationClosedWebhookEvent](/reference/schemas/conversation-closed-webhook-event.md) - object
- [MessageCreatedWebhookEvent](/reference/schemas/message-created-webhook-event.md) - object
- [MessageWebhookEventData](/reference/schemas/message-webhook-event-data.md) - object - Message snapshot and related public resources.
- [MessageUpdatedWebhookEvent](/reference/schemas/message-updated-webhook-event.md) - object