--- title: "POST /providers" method: POST path: "/providers" --- # POST /providers `POST /providers` Creates a new provider record. Providers must be created before they can be enrolled with payers. ## Request body - CreateProviderRequestContent — Information about the provider you want to add to your account. The provider **must** have a unique NPI from other providers in your account. - `contacts` ProviderContact[] — The contact information for the provider. These contacts appear as prepopulated options for contact information when creating enrollment requests for this provider in the Stedi portal. They aren't automatically added to enrollment requests. These contacts should specify where payers should send communications about the enrollment, if needed. - Either `organizationName` _or_ `firstName` and `lastName` are required. - The name and address should match exactly what the payer has on file for the provider. Some payers reject enrollment requests with addresses that don't match their records. - If you're submitting enrollment requests on a provider's behalf, you may want to set the phone number and email to your own contact details. Do this when you want the payer to contact you about the enrollment status instead of the provider directly. - These contacts are for convenience only. You can specify different contacts on enrollment requests as needed. - `city` string, required — The contact's city. This should match exactly what the payer has on file for the provider. - `email` string, required — The contact's email address. Set this to where you want the payer to send communications regarding the enrollment. This can be different from the provider's email if needed. - `firstName` string — The contact's first name. This should match exactly what the payer has on file for the provider. - `lastName` string — The contact's last name. This should match exactly what the payer has on file for the provider. - `organizationName` string — The contact's business name. This should match exactly what the payer has on file for the provider. - `phone` string, required — The contact's phone number. Set this to where you want the payer to direct communications regarding the enrollment. This can be different from the provider's phone number if needed. - `state` 'AA' | 'AE' | 'AK' | 'AL' | 'AP' | 'AR' | 'AS' | 'AZ' | 'CA' | 'CO' | 'CT' | 'DC' | 'DE' | 'FL' | 'FM' | 'GA' | 'GU' | 'HI' | 'IA' | 'ID' | 'IL' | 'IN' | 'KS' | 'KY' | 'LA' | 'MA' | 'MD' | 'ME' | 'MH' | 'MI' | 'MN' | 'MO' | 'MP' | 'MS' | 'MT' | 'NC' | 'ND' | 'NE' | 'NH' | 'NJ' | 'NM' | 'NV' | 'NY' | 'OH' | 'OK' | 'OR' | 'PA' | 'PR' | 'PW' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'VI' | 'WA' | 'WV' | 'WI' | 'WY', required — United States state and territory codes using standard two-letter abbreviations. - `streetAddress1` string, required — The contact's street address, including the street number, name, and any suite or apartment number. This should match exactly what the payer has on file for the provider. - `streetAddress2` string — The contact's street address continued. This should match exactly what the payer has on file for the provider. - `zipCode` string, required — The contact's five-digit ZIP code. This should match exactly what the payer has on file for the provider. - `name` string, required — The provider's business name. This is typically the provider's practice name, such as `Dental Associates, LLC`, but it can also be the provider's first and last name. - `npi` string, required — The provider's [National Provider Identifier (NPI)](https://npiregistry.cms.hhs.gov/search). This is a 10-digit number that is unique to the provider. Each provider record must have a unique `npi` and `taxId` combination. For example, you can create two provider records with the same `npi` as long as they have different values for `taxId`. - `taxId` string, required — The provider's tax ID, as specified by `taxIdType`. This identifier has to be provided without any separators, such as dashes or spaces. For example 111-22-3333 is invalid but `111223333` is valid. Each provider record must have a unique `npi` and `taxId` combination. For example, you can create two provider records with the same `taxId` as long as they have different values for `npi`. - `taxIdType` 'EIN' | 'SSN', required — The type of tax identification number. Organizations (Type 2 NPIs) must use `EIN`, while individual providers (Type 1 NPIs) can use either `EIN` or `SSN`. ## Response `200` CreateProvider 200 response - CreateProviderResponseContent — Output containing the created provider details. - `contacts` ProviderContact[] — The contact information for the provider. These contacts appear as prepopulated options for contact information when creating enrollment requests for this provider in the Stedi portal. They aren't automatically added to enrollment requests. These contacts should specify where payers should send communications about the enrollment, if needed. - `city` string, required — The contact's city. This should match exactly what the payer has on file for the provider. - `email` string, required — The contact's email address. Set this to where you want the payer to send communications regarding the enrollment. This can be different from the provider's email if needed. - `firstName` string — The contact's first name. This should match exactly what the payer has on file for the provider. - `lastName` string — The contact's last name. This should match exactly what the payer has on file for the provider. - `organizationName` string — The contact's business name. This should match exactly what the payer has on file for the provider. - `phone` string, required — The contact's phone number. Set this to where you want the payer to direct communications regarding the enrollment. This can be different from the provider's phone number if needed. - `state` 'AA' | 'AE' | 'AK' | 'AL' | 'AP' | 'AR' | 'AS' | 'AZ' | 'CA' | 'CO' | 'CT' | 'DC' | 'DE' | 'FL' | 'FM' | 'GA' | 'GU' | 'HI' | 'IA' | 'ID' | 'IL' | 'IN' | 'KS' | 'KY' | 'LA' | 'MA' | 'MD' | 'ME' | 'MH' | 'MI' | 'MN' | 'MO' | 'MP' | 'MS' | 'MT' | 'NC' | 'ND' | 'NE' | 'NH' | 'NJ' | 'NM' | 'NV' | 'NY' | 'OH' | 'OK' | 'OR' | 'PA' | 'PR' | 'PW' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VT' | 'VA' | 'VI' | 'WA' | 'WV' | 'WI' | 'WY', required — United States state and territory codes using standard two-letter abbreviations. - `streetAddress1` string, required — The contact's street address, including the street number, name, and any suite or apartment number. This should match exactly what the payer has on file for the provider. - `streetAddress2` string — The contact's street address continued. This should match exactly what the payer has on file for the provider. - `zipCode` string, required — The contact's five-digit ZIP code. This should match exactly what the payer has on file for the provider. - `createdAt` string, date-time — The date and time Stedi created the provider record. - `id` string, required — A unique identifier Stedi assigns to this provider. - `name` string, required — The provider's business name. This is typically the provider's practice name, such as `Dental Associates, LLC`, but it can also be the provider's first and last name. - `npi` string, required — The provider's [National Provider Identifier (NPI)](https://npiregistry.cms.hhs.gov/search). This is a 10-digit number that is unique to the provider. Each provider record must have a unique `npi` and `taxId` combination. For example, you can create two provider records with the same `npi` as long as they have different values for `taxId`. - `taxId` string — The provider's tax ID, as specified by `taxIdType`. This identifier has to be provided without any separators, such as dashes or spaces. For example 111-22-3333 is invalid but `111223333` is valid. Each provider record must have a unique `npi` and `taxId` combination. For example, you can create two provider records with the same `taxId` as long as they have different values for `npi`. - `taxIdType` 'EIN' | 'SSN' — The type of tax identification number. Organizations (Type 2 NPIs) must use `EIN`, while individual providers (Type 1 NPIs) can use either `EIN` or `SSN`. - `updatedAt` string, date-time — The date and time Stedi last updated the provider record. ## Other responses - `400` — ValidationException 400 response - `401` — UnauthorizedException 401 response - `403` — AccessDeniedException 403 response - `404` — ResourceNotFoundException 404 response - `429` — QuotaExceededException 429 response - `500` — InternalFailureException 500 response - `503` — ServiceUnavailableException 503 response - `504` — GatewayTimeoutException 504 response --- [API](https://skmtc.net/stedi/apis/stedi-enrollment.md) · [All operations](https://skmtc.net/stedi/apis/stedi-enrollment/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stedi/stedi-enrollment/versions/0a692cc4f303/schema)