# Send Workflow Fax

> Perform Send Workflow Fax through MyForms.

Source: [https://genhealth.ai/docs/workflows/integrations/my-forms/myforms_send_workflow_fax](https://genhealth.ai/docs/workflows/integrations/my-forms/myforms_send_workflow_fax)

Integration: [MyForms](https://genhealth.ai/docs/workflows/integrations/my-forms.md)

- Handler: `myforms_send_workflow_fax`

## Inputs

- `workflow_id` — Workflow Id (text, required)
  Required text value.
- `document_ids` — Document Ids (json, required)
  Required JSON value.
- `recipient_name` — Recipient Name (text, required)
  Required text value.
- `recipient_fax_number` — Recipient Fax Number (text, required)
  Required text value.
- `recipient_phone_number` — Recipient Phone Number (text)
  Optional text value.
- `cover_sheet_title` — Cover Sheet Title (text, required)
  Required text value.
- `cover_sheet_id` — Cover Sheet Id (text)
  Optional text value.
- `notes_html` — Notes Html (textarea)
  Optional text value.
- `fax_number_id` — Fax Number Id (text)
  Optional text value.
- `timeout_seconds` — Timeout Seconds (number)
  Optional numeric value.
  Default: `180`

## Outputs

- `success` — Success
- `sent` — Sent
- `document_ids` — Document Ids
- `error_message` — Error Message

Output schema completeness: `best_effort_declared`

## Safety

- External effect: `write`
- Confirmation recommended: no
- Retry safe: no
- Dry run supported: no

## Schemas

These schemas are first-pass authoring guidance. Runtime validation remains authoritative.

### Input schema

```json
{
  "type": "object",
  "required": [
    "workflow_id",
    "document_ids",
    "recipient_name",
    "recipient_fax_number",
    "cover_sheet_title"
  ],
  "properties": {
    "notes_html": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "textarea"
    },
    "workflow_id": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "document_ids": {
      "description": "Required JSON value.",
      "x-workflow-field-type": "json"
    },
    "fax_number_id": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "cover_sheet_id": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "recipient_name": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "timeout_seconds": {
      "type": "number",
      "default": 180,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "cover_sheet_title": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "recipient_fax_number": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "recipient_phone_number": {
      "type": "string",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "sent": {},
    "success": {},
    "document_ids": {},
    "error_message": {}
  },
  "additionalProperties": true
}
```