# 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.
Example Payload
```
{
"medicare_application": {
"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",
"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"]
}
]
}
]
}
}
```
## 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":["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":{"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","descript":"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"},"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"}}}},"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"},"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"}}}}}}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.medicare.healthsherpa.com/webhooks/event-types/submission.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.