Skip to main content
This guide shows you how to register an OAuth client with Homeworks (formerly Copilot CRM) to get a client ID.
1

Check API access

Homeworks API access requires an Enterprise plan or an active Growth trial.
2

Register an OAuth client

Homeworks registers clients through its registration endpoint. Send one request per app and environment:
Use your own custom callback URL in redirect_uris if you have one. Copy the client_id from the response.
3

Add the client ID in Nango

Paste the client ID into your Homeworks integration in Nango and leave the client secret empty. Nango uses PKCE (S256) and requests the openid and company scopes.
4

Next

Follow the Quickstart.
Access tokens expire after one hour and refresh tokens after 14 days. Refresh tokens rotate on each use; Nango stores the new refresh token every time it refreshes. For more details, see the Homeworks API OAuth authentication guide.