> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tetherai.ca/llms.txt
> Use this file to discover all available pages before exploring further.

# Trigger an application from an external system

> Webhook entry point used by external systems (mortgage CRMs, custom integrations) to push an application into Tether. Creates or updates the contact (matched by phone), creates the Application record, and emits the downstream events that fire automations. Requires the per-org API key.



## OpenAPI

````yaml /api-reference/openapi.yaml post /api/application-trigger
openapi: 3.0.3
info:
  title: Tether Relay and Tether API
  version: 1.0.0
  description: >-
    Route-derived OpenAPI contract generated from tether-relay backend sources.
    Regenerate with scripts/sync-openapi-from-backend.mjs.
servers:
  - url: https://your-instance.example.com
    description: Production
  - url: http://localhost:2212
    description: Local API service
security: []
tags:
  - name: AI
  - name: Applications
  - name: Approval
  - name: Auth
  - name: Automations
  - name: Calls
  - name: Campaigns
  - name: Contact Analytics
  - name: Contact Metrics
  - name: Contact Notes
  - name: Contacts
  - name: Conversation Monitor
  - name: Conversations
  - name: Departments
  - name: Email
  - name: Escalation Dashboard
  - name: Event Logs
  - name: Google Sheets
  - name: Marketplace
  - name: Messages
  - name: Notification Sounds
  - name: Notifications
  - name: Org Snapshots
  - name: Organizations
  - name: Outreach
  - name: Outreach Metrics
  - name: Outreach Sources
  - name: Pipelines
  - name: Processes
  - name: Prompts
  - name: Reminders
  - name: Sms
  - name: Templates
  - name: Traces
  - name: Training
  - name: Upload
  - name: User Snapshots
  - name: Users
  - name: Vertical
  - name: Webchats
  - name: Webhook
paths:
  /api/application-trigger:
    post:
      tags:
        - ApplicationTrigger
      summary: Trigger an application from an external system
      description: >-
        Webhook entry point used by external systems (mortgage CRMs, custom
        integrations) to push an application into Tether. Creates or updates the
        contact (matched by phone), creates the Application record, and emits
        the downstream events that fire automations. Requires the per-org API
        key.
      operationId: post_application_trigger
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggerApplicationRequest'
      responses:
        '200':
          description: Application received successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TriggerApplicationResponse'
        '400':
          description: Missing required fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationTriggerErrorResponse'
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationTriggerErrorResponse'
        '500':
          description: Error processing application webhook
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationTriggerErrorResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    TriggerApplicationRequest:
      type: object
      properties:
        phoneNumber:
          type: array
          items:
            type: object
            properties:
              value:
                type: string
              isActive:
                type: boolean
            required:
              - value
        firstName:
          type: string
        lastName:
          type: string
        name:
          type: string
          description: Application name
        status:
          type: string
          description: Application status
        description:
          type: string
        notes:
          type: string
        amount:
          type: number
        loanType:
          type: string
        applicationDate:
          type: string
      required:
        - phoneNumber
        - firstName
        - lastName
        - name
        - status
      additionalProperties: true
      example:
        phoneNumber:
          - value: '+14155550123'
            isActive: true
        firstName: Jane
        lastName: Doe
        name: Refi 2026-05
        status: submitted
        amount: 425000
        loanType: conventional
        applicationDate: '2026-05-18'
        notes: Referred by Brenda
    TriggerApplicationResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        data:
          type: object
          properties:
            application:
              type: object
              additionalProperties: true
            contact:
              type: object
              properties:
                id:
                  type: string
                phoneNumber:
                  type: array
                  items:
                    type: object
                    properties:
                      value:
                        type: string
                      isPrimary:
                        type: boolean
                    required:
                      - value
                firstName:
                  type: string
                lastName:
                  type: string
          additionalProperties: true
      additionalProperties: true
      example:
        success: true
        message: Application received successfully
        data:
          application:
            _id: 66b0a0b0c0d0e0f0a0b0c0d0
            name: Refi 2026-05
            status: submitted
            amount: 425000
          contact:
            id: 65c2d0e0f0a0b0c0d0e0f0a0
            phoneNumber:
              - value: '+14155550123'
                isPrimary: true
            firstName: Jane
            lastName: Doe
    ApplicationTriggerErrorResponse:
      type: object
      description: >-
        Error envelope for `/api/application-trigger` (legacy API-key authed
        external entry point).
      properties:
        error:
          type: string
        message:
          type: string
        success:
          type: boolean
          enum:
            - false
      required:
        - error
      additionalProperties: true
      example:
        error: Invalid API key
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````