--- title: "Creates a new end customer for a Plaid reseller." method: POST path: "/partner/customer/create" tags: ["plaid"] --- # Creates a new end customer for a Plaid reseller. `POST /partner/customer/create` The `/partner/customer/create` endpoint is used by reseller partners to create end customers. To create end customers, it should be called in the Production environment only, even when creating Sandbox API keys. If called in the Sandbox environment, it will return a sample response, but no customer will be created and the API keys will not be valid. ## Request body - PartnerCustomerCreateRequest — Request schema for `/partner/customer/create`. - `client_id` string — Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body. - `secret` string — Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body. - `company_name` string, required — The company name of the end customer being created. This will be used to display the end customer in the Plaid Dashboard. It will not be shown to end users. - `is_diligence_attested` boolean, required — Denotes whether or not the partner has completed attestation of diligence for the end customer to be created. - `products` Products[] — The products to be enabled for the end customer. If empty or `null`, this field will default to the products enabled for the reseller at the time this endpoint is called. - `create_link_customization` boolean — If `true`, the end customer's default Link customization will be set to match the partner's. You can always change the end customer's Link customization in the Plaid Dashboard. See the [Link Customization docs](https://plaid.com/docs/link/customization/) for more information. If you require the ability to programmatically create end customers using multiple different Link customization profiles, contact your Plaid account manager for assistance. Important: Data Transparency Messaging (DTM) use cases will not be copied to the end customer's Link customization unless the **Publish changes** button is clicked after the use cases are applied. Link will not work in Production unless the end customer's DTM use cases are configured. For more details, see [Data Transparency Messaging](https://plaid.com/docs/link/data-transparency-messaging-migration-guide/). - `logo` string — Base64-encoded representation of the end customer's logo. Must be a PNG of size 1024x1024 under 4MB. The logo will be shared with financial institutions and shown to the end user during Link flows. A logo is required if `create_link_customization` is `true`. If `create_link_customization` is `false` and the logo is omitted, the partner's logo will be used if one exists, otherwise a stock logo will be used. - `legal_entity_name` string, required — The end customer's legal name. This will be shared with financial institutions as part of the OAuth registration process. It will not be shown to end users. - `website` string, required — The end customer's website. - `application_name` string, required — The name of the end customer's application. This will be shown to end users when they go through the Plaid Link flow. The application name must be unique and cannot match the name of another application already registered with Plaid. - `technical_contact` PartnerEndCustomerTechnicalContact — The technical contact for the end customer. Defaults to partner's technical contact if omitted. - `given_name` string - `family_name` string - `email` string - `billing_contact` PartnerEndCustomerBillingContact — The billing contact for the end customer. Defaults to partner's billing contact if omitted. - `given_name` string - `family_name` string - `email` string - `customer_support_info` PartnerEndCustomerCustomerSupportInfo — This information is public. Users of your app will see this information when managing connections between your app and their bank accounts in Plaid Portal. Defaults to partner's customer support info if omitted. This field is mandatory for partners whose Plaid accounts were created after November 26, 2024 and will be mandatory for all partners by the 1033 compliance deadline. - `email` string — This field is mandatory for partners whose Plaid accounts were created after November 26, 2024 and will be mandatory for all partners by the 1033 compliance deadline. - `phone_number` string - `contact_url` string - `link_update_url` string - `address` PartnerEndCustomerAddress, required — The end customer's address. - `city` string - `street` string - `region` string - `postal_code` string - `country_code` string — ISO-3166-1 alpha-2 country code standard. - `is_bank_addendum_completed` boolean, required — Denotes whether the partner has forwarded the Plaid bank addendum to the end customer. - `assets_under_management` PartnerEndCustomerAssetsUnderManagement — Assets under management for the given end customer. Required for end customers with monthly service commitments. - `amount` number, double, required - `iso_currency_code` string, required - `redirect_uris` string[] — A list of URIs indicating the destination(s) where a user can be forwarded after completing the Link flow; used to support OAuth authentication flows when launching Link in the browser or another app. URIs should not contain any query parameters. When used in Production, URIs must use https. To modify redirect URIs for an end customer after creating them, go to the end customer's [API page](https://dashboard.plaid.com/team/api) in the Dashboard. - `registration_number` string — The unique identifier assigned to a financial institution by regulatory authorities, if applicable. For banks, this is the FDIC Certificate Number. For credit unions, this is the Credit Union Charter Number. ## Response `200` OK - PartnerCustomerCreateResponse — Response schema for `/partner/customer/create`. - `end_customer` PartnerEndCustomerWithSecrets — The details for an end customer. - `client_id` string — The `client_id` of the end customer. - `company_name` string — The company name associated with the end customer. - `status` 'UNDER_REVIEW' | 'PENDING_ENABLEMENT' | 'ACTIVE' | 'DENIED' | 'MORE_INFORMATION_NEEDED' — The status of the given end customer. `UNDER_REVIEW`: The end customer has been created and enabled in the Sandbox environment. The end customer must be manually reviewed by the Plaid team before it can be enabled in Production, at which point its status will automatically transition to `PENDING_ENABLEMENT` or `DENIED`. `PENDING_ENABLEMENT`: The end customer is ready to be fully enabled in the Production environment. Call the `/partner/customer/enable` endpoint to enable the end customer in full Production. `ACTIVE`: The end customer has been fully enabled in all environments. `DENIED`: The end customer has been created and enabled in the Sandbox environment, but it did not pass review by the Plaid team and therefore cannot be enabled for Production access. Talk to your account manager for more information. - `secrets` PartnerEndCustomerSecrets — The secrets for the newly created end customer. - `sandbox` string — The end customer's secret key for the Sandbox environment. - `development` string — The end customer's secret key for the Development environment. The Development environment has been removed. - `production` string — The end customer's secret key for the Production environment. The end customer will be provided with a limited number of credits to test in the Production environment before full enablement. - `request_id` string — A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive. ## Other responses - `default` — Error response --- [API](https://skmtc.net/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.net/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/versions/64c4514ea59b/schema)