> 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",
    "benefits_document_url": "https://example.com/summary-of-benefits.pdf",
    "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",
    "sex": "male",
    "status": "enrolled",
    "email": "test.enrollment@example.com",
    "phone_number": "3055551234",
    "phone_number_type": "cell",
    "phone_number_2": "3055555678",
    "phone_number_2_type": "home",
    "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",
    "mailing_address_city": "Miami",
    "mailing_address_state": "FL",
    "mailing_address_street": "321 Main Street",
    "mailing_address_unit_number": "Apt 101",
    "mailing_address_zip_code": "33101",
    "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"},"benefits_document_url":{"type":"string","format":"uri","nullable":true,"description":"URL of the plan benefits document captured at enrollment. This is the Summary of Benefits for MAPD, MA, and PDP plans, and the Outline of Coverage for Medicare Supplement plans. Null when no document was captured."},"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 signed with the agent."},"state":{"type":"string","description":"State code (2-letter)"},"sep":{"type":"string","description":"SEP reason code"},"signature":{"type":"string","description":"Signature type","enum":["e_signature","in_person_signature","remote_signature","voice_signature"]},"submitted_at":{"type":"string","format":"date-time","description":"Timestamp when the application was submitted"},"submitting_agent_email":{"type":"string","format":"email","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"},"sex":{"type":"string","enum":["female","male"],"description":"Contact's sex"},"status":{"type":"string","enum":["new","contacted","in_progress","enrolled","not_interested","inactive","do_not_contact","deceased"],"description":"Contact's workflow status. Unsupported values are treated as `new`."},"email":{"type":"string","format":"email","description":"Email address"},"phone_number":{"type":"string","description":"Primary phone number"},"phone_number_2":{"type":"string","description":"Secondary phone number"},"phone_number_2_type":{"type":"string","enum":["cell","home","work","other"],"description":"Type of secondary phone number"},"phone_number_type":{"type":"string","enum":["cell","home","work","other"],"description":"Type of primary 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"},"mailing_address_street":{"type":"string","description":"Street address for mailing"},"mailing_address_unit_number":{"type":"string","description":"Unit number for mailing address"},"mailing_address_city":{"type":"string","description":"City for mailing address"},"mailing_address_state":{"type":"string","description":"State code (2-letter) for mailing address"},"mailing_address_zip_code":{"type":"string","description":"ZIP code for mailing address"},"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":"number","format":"float","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"}}}}}}
```