Create a private integration token
Create a one-time Lead360 credential for one sub-account, choose the smallest production scopes, set expiration and rate controls, and store the secret before leaving the confirmation screen.
How this fits into Lead360Explore the Lead360 platformConnect API and MCP access with the agency, tenant, scope, and risk model.- 01
Prepare the integration request
- 02
Create the credential
- 03
Protect the one-time token
- 04
Verify before production use
Prepare the integration request
Before creating a credential, identify the integration owner, destination sub-account, business purpose, required data, expected request rate, retention period, incident contact, and retirement date. This makes the scope review concrete and gives the business a record of why access exists.
- Use a name that identifies the system and owner, such as Support reporting server.
- Prefer read-only scopes for reporting, retrieval, synchronization, and validation.
- Do not select a broad category merely because the integration might use it later.
- Set a finite expiration for temporary work and a rotation schedule for long-lived services.
- Choose a rate limit based on measured need rather than the maximum value.
Create the credential
- Sign in, choose the exact destination sub-account, and open Settings.
- Select Developers and confirm that private integration management is enabled.
- Select New private integration.
- Enter an integration name, optional expiration, and requests-per-minute limit.
- Search tools and abilities, review the risk badge and description, and select the minimum scopes.
- Submit the form and review the credential summary.
- Copy the one-time token directly into an approved secret manager.
- Copy the MCP configuration or REST base and test the connection before closing the panel.
Protect the one-time token
Lead360 displays the token once and stores a one-way hash. It cannot show the same secret later. Do not paste the token into Ask360 chats, support tickets, source files, screenshots, memory documents, playbooks, kit archives, analytics, or ordinary application logs.
Place the credential in a dedicated secret manager or encrypted deployment secret. Restrict access to the runtime identity that needs it, prevent command tracing from printing it, redact authorization headers, and rotate immediately after suspected exposure.
Verify before production use
- Call the version 2 status endpoint with Bearer authentication.
- Confirm authenticated is true and the location matches the intended destination.
- Compare returned scopes with the approved integration request.
- Search operations and confirm that unrelated operation groups do not appear.
- Run one controlled read using non-sensitive test data where possible.
- Verify rate-limit headers and error handling before increasing traffic.
- Record the key identifier, owner, creation date, expiration, and rotation date without recording the secret.
Handle later scope changes as a new access decision
Do not quietly expand an established token when the integration gains a new feature. Document the new purpose and fields, review the destination system, select only the additional required scopes, and repeat discovery and negative-access tests. A separate credential is usually clearer when the new workflow has another owner, environment, retention rule, or risk profile.
After creation, the integration list is the operational record for status, expiration, rate limit, last use, rotation, and revocation. Review it against the secret manager and deployment inventory so abandoned credentials are found before they become permanent background access.
Frequently asked questions
What happens if I close the page before storing the token?
The secret cannot be recovered. Rotate the newly created integration to issue a replacement credential, store it securely, and stop using the previous value.
Should a token be placed in frontend JavaScript?
No. Private integration tokens belong in a trusted server-side environment or an approved MCP client secret store, never in public browser code.
Can I reuse a token for development and production?
Use separate credentials with separate owners, scopes, rate limits, and expiration policies so testing cannot silently inherit production authority.
Continue with Lead360
Use this workflow in Lead360
Put this guide into practice with a 14-day free trial of Lead360 Pro early access, or continue learning through the related collection.
Support