> For the complete documentation index, see [llms.txt](https://docs.medicare.healthsherpa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.medicare.healthsherpa.com/webhooks/event-types/submission.md).

# Submission

This event is sent to the configured destination URL when an application is submitted via HealthSherpa for Medicare.

**Details:**

* The webhook includes automatic retries – three attempts at 20 seconds, 10 minutes, and 1 hour after the initial delivery, if it fails.
* If you're connecting to a HealthSherpa Medicare **agency** account, then any connected downline **agent** accounts will be included in the scope of this webhook.
  * Enrollments from accounts joined to you as **captive** agents send all application and contact fields in the payload.
  * Enrollments from accounts joined to you as **independent** agents receive all application fields and a limited subset of contact fields. 
  * See the `SubmissionPayload` section below for details.

<details>

<summary>Example Payload</summary>

```
{
  "medicare_application": {
    "id": "ccf19b98-375f-4467-87f4-a47c977359ee",
    "carrier_name": "Devoted Health",
    "cms_plan_id": "H1290-001-000",
    "confirmation_number": "A92946987696546M",
    "created_at": "2026-01-21T19:54:21.186Z",
    "effective_date": "2026-02-01",
    "fips_code": "12086",
    "plan_name": "DEVOTED CORE 001 FL (HMO)",
    "plan_sub_type": "hmo",
    "plan_type": "mapd",
    "plan_year": 2026,
    "send_to_beneficiary": false,
    "sep": "NEW",
    "signature": "voice_signature",
    "state": "FL",
    "submitted_at": "2026-01-21T19:56:43.302Z",
    "submitting_agent_first_name": "Heath",
    "submitting_agent_last_name": "Sherpa",
    "submitting_agent_npn": "1234567890",
    "total_premium_cents": 5000,
    "updated_at": "2026-01-21T19:56:52.627Z",
    "zip_code": "33101"
  },
  "medicare_application_riders": [
    {
      "plan_name": "Dental Plus",
      "premium_cents": 2500,
      "created_at": "2026-01-21T19:54:21.186Z",
      "updated_at": "2026-01-21T19:54:21.186Z"
    },
    {
      "plan_name": "Vision Coverage",
      "premium_cents": 2500,
      "created_at": "2026-01-21T19:54:21.186Z",
      "updated_at": "2026-01-21T19:54:21.186Z"
    }
  ],
  "contact": {
    "id": "8b420678-2c58-4f56-9c0b-9ccb605e5e85",
    "external_id": "CRM789012",
    "first_name": "Test",
    "middle_name": "Person",
    "last_name": "Enrollment",
    "suffix": "Jr.",
    "birth_date": "1960-09-09",
    "email": "test.enrollment@example.com",
    "phone_number": "3055551234",
    "language": "English",
    "lead_source": "Website",
    "primary_address_street": "123 Main Street",
    "primary_address_unit_number": "Apt 101",
    "primary_address_city": "Miami",
    "primary_address_state": "FL",
    "primary_address_zip_code": "33101",
    "primary_address_county": "Miami-Dade",
    "primary_address_fips_code": "12086",
    "authorized_representative_name": "Child of Test Enrollment",
    "authorized_representative_relationship": "natural_child",
    "authorized_representative_address": "123 Main Street",
    "authorized_representative_city": "Miami",
    "authorized_representative_state": "FL",
    "authorized_representative_zip_code": "33101",
    "authorized_representative_phone_number": "3055551235",
    "authorized_representative_email": "child.enrollment@example.com",
    "medicaid_eligible": false,
    "medicaid_enrolled": false,
    "medicaid_number": null,
    "medicare_number": "1EG4TE5MK73",
    "needs_extra_help": false,
    "part_a_effective_date": "2020-07-01",
    "part_b_effective_date": "2020-07-01",
    "created_at": "2026-01-21T19:53:25.236Z",
    "updated_at": "2026-01-21T19:54:15.234Z",
    "contact_drugs_attributes": [
      {
        "frequency": 30,
        "dosage_id": "dosage-cx-001",
        "dosage_id_source": "connecture",
        "metric_quantity": null,
        "ndc": "00093-7150-01",
        "package_description": null,
        "package_size": null,
        "package_quantity": null,
        "user_quantity": 1,
        "id": "drug-cx-001",
        "id_source": "connecture",
        "dosage_name": "10 mg tablet",
        "name": "Lisinopril",
        "drug_type_id": 2
      }
    ],
    "contact_pharmacies_attributes": [
      {
        "address_city": "Miami",
        "address_state": "FL",
        "address_street": "456 Pharmacy Lane",
        "address_unit_number": null,
        "address_zip_code": "33101",
        "npi": "1234567890",
        "primary": true,
        "id": "pharm-cx-001",
        "id_source": "connecture",
        "name": "CVS Pharmacy #1234",
        "mode": "retail",
        "phone_number": "+13055559876"
      }
    ],
    "contact_providers_attributes": [
      {
        "external_id": "prov-001",
        "primary": true,
        "provider_type": "individual",
        "first_name": "Sarah",
        "last_name": "Johnson",
        "organization_name": null,
        "presentation_name": "Dr. Sarah L Johnson",
        "phone_number": "3055554321",
        "npi": "9876543210",
        "specialties": ["Internal Medicine"],
        "contact_provider_addresses_attributes": [
          {
            "id": "addr-cx-001",
            "id_source": "connecture",
            "street": "789 Medical Center Dr",
            "unit_number": "Suite 200",
            "city": "Miami",
            "state": "FL",
            "zip_code": "33101",
            "selected": true,
            "phone_numbers": ["3055554321"]
          }
        ]
      }
    ]
  }
}
```

</details>

## The SubmissionPayload object

```json
{"openapi":"3.0.3","info":{"title":"Medicare Webhook Payload Reference","version":"1.0.0"},"components":{"schemas":{"SubmissionPayload":{"type":"object","required":["medicare_application","medicare_application_riders","contact"],"properties":{"medicare_application":{"$ref":"#/components/schemas/MedicareApplication"},"medicare_application_riders":{"type":"array","items":{"$ref":"#/components/schemas/MedicareApplicationRider"},"description":"Array of Medicare application riders"},"contact":{"$ref":"#/components/schemas/Contact"}}},"MedicareApplication":{"type":"object","required":["id","carrier_name","cms_plan_id","plan_name","plan_type","plan_sub_type","submitting_agent_email","submitting_agent_first_name","submitting_agent_last_name","submitting_agent_npn","created_at","updated_at","submitted_at"],"properties":{"id":{"type":"string","format":"uuid","description":"HealthSherpa system unique identifier for the Medicare application"},"carrier_name":{"type":"string","description":"Name of the insurance carrier"},"cms_plan_id":{"type":"string","description":"CMS plan identifier"},"confirmation_number":{"type":"string","description":"Confirmation number for the submission"},"created_at":{"type":"string","format":"date-time","description":"Timestamp when the application was created"},"effective_date":{"type":"string","format":"date","description":"Effective date of the enrollment"},"fips_code":{"type":"string","description":"Federal Information Processing Standard code for county"},"plan_name":{"type":"string","description":"Name of the insurance plan"},"plan_sub_type":{"type":"string","enum":["cost","hmo","hmopos","lppo","msa","pffs","ppo","rppo","high_deductible","high_deductible_plan","plan_a","plan_b","plan_c","plan_d","plan_e","plan_f","plan_f_high_deductible","plan_f_innovative","plan_g","plan_g_high_deductible","plan_g_innovative","plan_h","plan_i","plan_j","plan_j_high_deductible","plan_k","plan_l","plan_m","plan_n","plan_n_innovative","supplement_1_plan","supplement_1a_plan","waiver_state_plan"],"description":"Sub-category of the plan"},"plan_type":{"type":"string","enum":["mapd","pdp","ma","med_supp"],"description":"Type of Medicare plan"},"plan_year":{"type":"integer","description":"Year of the plan enrollment"},"send_to_beneficiary":{"type":"boolean","description":"Flag indicating whether the application was sent to the beneficiary for signature or completed via voice signature"},"state":{"type":"string","description":"State code (2-letter)"},"sep":{"type":"string","description":"SEP reason code"},"signature":{"type":"string","description":"Signature type","enum":["e_signature","voice_signature"]},"submitted_at":{"type":"string","format":"date-time","description":"Timestamp when the application was submitted"},"submitting_agent_email":{"type":"string","description":"The email associated with the submitting agent"},"submitting_agent_first_name":{"type":"string","description":"First name of the submitting agent"},"submitting_agent_last_name":{"type":"string","description":"Last name of the submitting agent"},"submitting_agent_npn":{"type":"string","description":"National Producer Number of the submitting agent"},"total_premium_cents":{"type":"integer","description":"Total premium in cents, including the premium for all riders."},"updated_at":{"type":"string","format":"date-time","description":"Timestamp when the application was last updated"},"zip_code":{"type":"string","description":"ZIP code for the enrollment address"}}},"MedicareApplicationRider":{"type":"object","required":["plan_name","created_at","updated_at"],"properties":{"plan_name":{"type":"string","description":"Name of the rider plan"},"premium_cents":{"type":"integer","description":"Premium amount for the rider in cents"},"created_at":{"type":"string","format":"date-time","description":"Timestamp when the rider was created"},"updated_at":{"type":"string","format":"date-time","description":"Timestamp when the rider was last updated"}}},"Contact":{"oneOf":[{"$ref":"#/components/schemas/ContactFull"},{"$ref":"#/components/schemas/ContactLimited"}],"discriminator":{"propertyName":"contact_type"}},"ContactFull":{"type":"object","description":"Full contact fields, provided when the submitting agent is a captive downline agent of your agency.","required":["id","first_name","last_name"],"properties":{"id":{"type":"string","format":"uuid","description":"HealthSherpa system unique identifier for the contact"},"first_name":{"type":"string","description":"First name"},"middle_name":{"type":"string","description":"Middle name"},"last_name":{"type":"string","description":"Last name"},"suffix":{"type":"string","description":"Name suffix (Jr., Sr., etc.)"},"birth_date":{"type":"string","format":"date","description":"Date of birth"},"email":{"type":"string","format":"email","description":"Email address"},"phone_number":{"type":"string","description":"Phone number"},"language":{"type":"string","description":"Preferred language"},"lead_source":{"$ref":"#/components/schemas/LeadSource"},"external_id":{"type":"string","description":"External system identifier"},"primary_address_street":{"type":"string","description":"Street address"},"primary_address_unit_number":{"type":"string","description":"Unit number (apartment, suite, etc.)"},"primary_address_city":{"type":"string","description":"City"},"primary_address_state":{"type":"string","description":"State code (2-letter)"},"primary_address_zip_code":{"type":"string","description":"ZIP code"},"primary_address_county":{"type":"string","description":"County name"},"primary_address_fips_code":{"type":"string","description":"Federal Information Processing Standard code"},"authorized_representative_name":{"type":"string","description":"Name of authorized representative"},"authorized_representative_relationship":{"type":"string","enum":["natural_child","spouse","mother","father","power_of_attorney","other"],"description":"Relationship to the contact"},"authorized_representative_address":{"type":"string","description":"Address of authorized representative"},"authorized_representative_city":{"type":"string","description":"City of authorized representative"},"authorized_representative_state":{"type":"string","description":"State of authorized representative"},"authorized_representative_zip_code":{"type":"string","description":"ZIP code of authorized representative"},"authorized_representative_phone_number":{"type":"string","description":"Phone number of authorized representative"},"authorized_representative_email":{"type":"string","format":"email","description":"Email of authorized representative"},"medicaid_eligible":{"type":"boolean","description":"Whether contact is eligible for Medicaid"},"medicaid_enrolled":{"type":"boolean","description":"Whether contact is enrolled in Medicaid"},"medicaid_level":{"type":"string","description":"Medicaid level/category"},"medicaid_number":{"type":"string","description":"Medicaid identification number"},"medicare_number":{"type":"string","description":"Medicare identification number"},"needs_extra_help":{"type":"boolean","description":"Whether contact qualifies for Extra Help program"},"part_a_effective_date":{"type":"string","format":"date","description":"Effective date of Medicare Part A"},"part_b_effective_date":{"type":"string","format":"date","description":"Effective date of Medicare Part B"},"created_at":{"type":"string","format":"date-time","description":"Timestamp when contact was created"},"updated_at":{"type":"string","format":"date-time","description":"Timestamp when contact was last updated"},"contact_drug_attributes":{"type":"array","description":"Array of drugs associated with the contact","items":{"$ref":"#/components/schemas/ContactDrug"}},"contact_pharmacy_attributes":{"type":"array","description":"Array of pharmacies associated with the contact","items":{"$ref":"#/components/schemas/ContactPharmacy"}},"contact_provider_attributes":{"type":"array","description":"Array of providers associated with the contact","items":{"$ref":"#/components/schemas/ContactProvider"}}}},"LeadSource":{"type":"string","description":"Lead source","nullable":true,"enum":["client_referral","community_networking","company_lead","direct_mail","event","in_store_kiosk","lead_list","office_walk_in","paid_advertising","professional_referral","social_media","website"]},"ContactDrug":{"type":"object","required":["name","drug_type_id","dosage_name","ndc","frequency","user_quantity","id","id_source","dosage_id","dosage_id_source"],"properties":{"name":{"type":"string","description":"Name of the drug"},"drug_type_id":{"type":"string","description":"Drug type identifier"},"dosage_name":{"type":"string","description":"Name of the dosage"},"ndc":{"type":"string","description":"National Drug Code"},"frequency":{"type":"integer","description":"Frequency of the drug"},"user_quantity":{"type":"integer","description":"User quantity of the drug"},"id":{"type":"string","description":"HealthSherpa system unique identifier for the drug"},"id_source":{"type":"string","description":"Source system for the drug ID"},"dosage_id":{"type":"string","description":"HealthSherpa system unique identifier for the dosage"},"dosage_id_source":{"type":"string","description":"Source system for the dosage ID"},"package_description":{"type":"string","description":"Description of the package type"},"package_size":{"type":"integer","description":"Size of the package"},"package_quantity":{"type":"integer","description":"Quantity of the package"},"metric_quantity":{"type":"integer","description":"Metric quantity value"}}},"ContactPharmacy":{"type":"object","required":["name","mode","npi","primary"],"properties":{"id":{"type":"string","description":"HealthSherpa system unique identifier for the pharmacy"},"id_source":{"type":"string","description":"Source system for the pharmacy ID"},"name":{"type":"string","description":"Name of the pharmacy"},"mode":{"type":"string","description":"Mode of the pharmacy","enum":["retail","digital"]},"npi":{"type":"string","description":"National Provider Identifier"},"address_street":{"type":"string","description":"Pharmacy street address"},"address_unit_number":{"type":"string","description":"Pharmacy unit number"},"address_city":{"type":"string","description":"Pharmacy city"},"address_state":{"type":"string","description":"Pharmacy state"},"address_zip_code":{"type":"string","description":"Pharmacy ZIP code"},"primary":{"type":"boolean","description":"Whether this is the primary pharmacy"},"phone_number":{"type":"string","description":"Pharmacy phone number"}}},"ContactProvider":{"type":"object","required":["id","id_source","npi","specialties","contact_provider_addresses_attributes","primary"],"properties":{"id":{"type":"string","description":"HealthSherpa system unique identifier for the provider"},"id_source":{"type":"string","description":"Source system for the provider ID"},"provider_type":{"type":"string","description":"Type of provider","enum":["individual","organization"]},"presentation_name":{"type":"string","description":"Display name for the provider"},"npi":{"type":"string","description":"National Provider Identifier"},"organization_name":{"type":"string","description":"Organization name of the provider"},"phone_number":{"type":"string","description":"Provider phone number"},"first_name":{"type":"string","description":"Provider first name"},"last_name":{"type":"string","description":"Provider last name"},"specialties":{"type":"array","description":"List of provider specialties","items":{"type":"string"}},"contact_provider_addresses_attributes":{"type":"array","description":"Array of addresses for this provider","items":{"$ref":"#/components/schemas/ContactProviderAddress"}},"primary":{"type":"boolean","description":"Whether this is the primary provider"}}},"ContactProviderAddress":{"type":"object","required":["id","id_source","city","state","zip_code","phone_numbers","selected"],"properties":{"id":{"type":"string","description":"HealthSherpa system unique identifier for the address"},"id_source":{"type":"string","description":"Source system for the address ID"},"street":{"type":"string","description":"Street address"},"unit_number":{"type":"string","description":"Unit number"},"city":{"type":"string","description":"City"},"state":{"type":"string","description":"State code (2-letter)"},"zip_code":{"type":"string","description":"ZIP code"},"selected":{"type":"boolean","description":"Whether this address is selected/preferred"},"phone_numbers":{"type":"array","description":"List of phone numbers for this address","items":{"type":"string"}}}},"ContactLimited":{"type":"object","description":"Limited contact fields, provided when the submitting agent is an independent agent.","required":["id","first_name","last_name"],"properties":{"id":{"type":"string","format":"uuid","description":"HealthSherpa system unique identifier for the contact"},"first_name":{"type":"string","description":"First name"},"middle_name":{"type":"string","description":"Middle name"},"last_name":{"type":"string","description":"Last name"},"suffix":{"type":"string","description":"Name suffix"},"primary_address_state":{"type":"string","description":"State code (2-letter)"},"primary_address_zip_code":{"type":"string","description":"ZIP code"},"lead_source":{"$ref":"#/components/schemas/LeadSource"},"external_id":{"type":"string","description":"External system identifier"},"created_at":{"type":"string","format":"date-time","description":"Timestamp when contact was created"},"updated_at":{"type":"string","format":"date-time","description":"Timestamp when contact was last updated"}}}}}}
```