How to Create a Cloverleaf Integration as a Developer
Step 1: Contact the Cloverleaf engineer team at support@cloverleaf.me and tell us you’re creating a Cloverleaf Integration.
Provide us with the following information:
1. Integration name
2. Description
3. Square logo image (ideally 80x80 px or larger)
4. Integration documentation URL OR company URL
5. Support URL OR email address
6. Best point of contact’s email address for this integration, which might be yours
7. Your integration's callback URL / redirect URI (which you see referenced in below instructions)
In return, we will issue you a client ID and client secret. We use the OpenID Connect (OIDC) protocol for authentication and these pertain to it.
Step 2: Now that you have the client ID and secret, you can integrate using OIDC.
To obtain an access token you should make a POST request to https://app.cloverleaf.me/api/oidc/token with a x-www-form-urlencoded request body like so, substituting your credentials provided by our team:
grant_type: client_credentials
client_id: YOUR_CLIENT_ID
client_secret: YOUR_CLIENT_SECRET
response_type: code
An access_token will be returned, allowing the integration access to Cloverleaf on behalf of the user.
Provide this access_token in the authorization header as a bearer token when calling the Cloverleaf Public API endpoint:
GET https://app.cloverleaf.me/public-api/v1/organization
