For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact usLogin
GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelog
  • Introduction
    • Overview
    • Authentication
    • Errors
    • Software Development Kits
    • Webhooks and Events
    • Sandbox Simulations
  • Core Resources
  • DAFpay
      • POSTCreate Connect
      • GETGet Connect
  • Disbursements
  • Gift Processing
LogoLogo
Contact usLogin
DAFpayConnects

Create Connect

POST
/v1/connects
POST
/v1/connects
$curl -X POST https://api.givechariot.com/v1/connects \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "organization_id": "org_1234567890",
>  "contact": {
>    "email": "ben.give@co.com"
>  }
>}'
1{
2  "id": "test_de5a2e7d-c960-4eaa-8bd2-e8d2cc5b1a55",
3  "apiKey": "test_98235982835",
4  "name": "website",
5  "active": true,
6  "createdAt": "2021-07-10 15:00:00.000",
7  "updatedAt": "2020-01-31T23:59:59Z",
8  "createdBy": "user123",
9  "metadata": {
10    "tag1": "value1"
11  }
12}
Get an existing connect or create a new connect for an existing nonprofit organization. The returned Connect can be used to integrate the client-side Chariot Connect component using the `id` property (CID) and also query for data generated from the Chariot Connect instance using the connect_id query parameter in any of the List Grants API endpoints. <Note> Only one Connect object can be created per organization. If one already exists, this will return a `200 OK` status with the existing object. </Note>
Was this page helpful?
Previous

Get Connect

Next
Built with

Get an existing connect or create a new connect for an existing nonprofit organization.

The returned Connect can be used to integrate the client-side Chariot Connect component using the id property (CID) and also query for data generated from the Chariot Connect instance using the connect_id query parameter in any of the List Grants API endpoints.

Only one Connect object can be created per organization. If one already exists, this will return a 200 OK status with the existing object.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

The request to create a new Connect object for a nonprofit.
organization_idstringRequired
The unique identifier for the organization
contactobjectRequired
namestringOptional
A human readable name of the Connect, optional.
metadatamap from strings to stringsOptional
A map of arbitrary string keys and values to store information about the object.

Response

OK
idstringRead-only

The unique identifier for this object. This is also the ‘publishable’ cid to use for initializing Connect for client-side integration.

apiKeystringRead-only

(deprecated) A secure token that can be used to make M2M API calls to read data generated by this object.

namestring
A human readable name for the connect, optional.
activeboolean
A flag to indicate if this connect is active. If true, then this Connect can process donations and grants, otherwise this Connect cannot process grants.
createdAtstringRead-onlyformat: "date-time"
Time when this object was created. Expressed in RFC 3339 format.
updatedAtstringRead-onlyformat: "date-time"
Time when this object was last updated. Expressed in RFC 3339 format.
createdBystringRead-only
ID of the user who created this object.
archivedbooleanRead-only
A flag to indicate if this object is marked for deletion.
metadatamap from strings to strings
A map of arbitrary string keys and values to store information about the object.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error