Skip to content

Make the provider for an entity I manage, or for myself​

POST
/resource-providers

Idempotent per entity: 201 the first time, 200 with the same provider after. The slug is the entity's own, with -2, -3 ... when another provider has it. Owners and admins (a business's owner or admin, a community's owner or leaders), or staff with manage_resources. Public programs are listed by staff. {kind: person} lists help as yourself (#2436, "List help as yourself"): it needs a verified email (403 email_not_verified, saying to verify it from Settings), a public name (422 name_required) and an account in good standing (403 account_not_active); idempotent per person; its slug follows your handle, or your name when the handle came from your email. Naming someone else's profile is a 404. Every listing it sends goes through staff review.

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
{
"kind": "string",
"entity_id": "string"
}

Responses​

Made (200 when it existed)

application/json
JSON
{
"created": true,
"provider": "string"
}

Playground​

Server
Authorization
Body

Samples​

Powered by VitePress OpenAPI

Built with VitePress