Before you begin
Request OAuth credentials from us via Discord support. You’ll start in dev or staging; production credentials come after you’ve validated your integration — see Going to Production.Environments
| Environment | Auth URL | API URL |
|---|---|---|
| Dev | https://auth.dev.endaoment.org | https://api.dev.endaoment.org |
| Staging | https://auth.staging.endaoment.org | https://api.staging.endaoment.org |
| Production | https://auth.endaoment.org | https://api.endaoment.org |
Standard OAuth journey
For apps where donors sign in with OAuth + PKCE and your backend proxies API calls on their behalf.| Step | Outcome | Key endpoint | Guide |
|---|---|---|---|
| 1 | User has an access token | /auth → /token | Authenticate |
| 2 | Donor has a fund | POST /v1/funds/partner | Open a Fund |
| 3 | Donation pledge created | POST /v1/donation-pledges/wire | Fund a DAF |
| 4 | Nonprofit selected | GET /v2/orgs/search | Find a Nonprofit |
| 5 | Grant submitted | POST /v1/transfers/async-grants | Recommend a Grant |
| 6 | Production-ready | — | Going to Production |
POST /v1/funds/partner — not POST /v1/funds. See Open a Fund for routing details.
Partner API journey
For tech-platform partners calling our server-to-server APIs with an API key. No donor OAuth login required on your side.| Step | Outcome | Key endpoint |
|---|---|---|
| 1 | Partner user provisioned | POST /v1/auth/partner/users |
| 2 | Partner fund created | POST /v1/funds/partner |
| 3 | Settled donation recorded | POST /v1/donation-pledges/partner/*-settled |
| 4 | Grant submitted | POST /v1/transfers/partner/grant-submissions |
| 5 | Missing org reported | POST /v1/missing-org-reports/tech-platform |