Create a non-profit draft from an EIN
POST
/nonprofits
Add flow (requireVerifiedEmail). Allowed for lookup outcomes verified and manual_review (and revoked with route: reinstatement). Creates the org (kind nonprofit, verification pending) with the caller as owner; one unfinished draft per person per EIN (the existing one is returned).
Authorizations
BearerAuth
In the browser, authentication rides on the httpOnly session cookies set by /cognito/signin or the Google / Apple sign-in at /cognito/oauth/{provider}. For scripts and for Swagger UI testing, paste an API key (fh_live_…, created with POST /api-keys); a Cognito JWT is accepted too. Sign-in does not return a token in its body.
Type
HTTP (bearer)
Request Body
application/json
JSON
{
"ein": "12-3456789",
"route": "string"
}
Responses
OK
application/json
JSON
{
"id": "string",
"slug": "string",
"status": "string",
"step": 0
}