Skip to main content
Getting Started

Create an App for Your Firm or Company

Create an API app inside Carta that can only access your own firm's or company's data.


If you are building an integration that only needs your own investment firm's or company's data, an administrator can create the app directly in Carta. You don't need a developer portal account.

An app created this way:

  • Belongs to the firm or company it was created in, and can only access that firm's or company's data
  • Uses the client credentials flow, so no Carta user has to log in to authorize it
  • Can only be given scopes that apply to a firm or a company:
    • Firm apps can be given the read_investor_* investor scopes and read_user_info. They can't be given readwrite_investor_* scopes, so they can't book capital calls, management fees, or carried interest.
    • Company apps can also be given readwrite_issuer_securities and readwrite_issuer_draftsecurities.
Building an app for other Carta customers?

If your app will access data for firms or companies other than your own, follow Create an App for Third Party Access to register it in our developer portal instead.

Create the app​

You must be an administrator of the firm or company.

  1. Log in to Carta and browse to your firm or company
  2. Open API access:
    • For an investment firm, go to Firm Settings and click API access
    • For a company, go to Company settings and click API access
  3. Click Add app, then click Create new app
  4. Enter an App name
  5. Select the scopes your app needs. Only scopes available to a firm or company are shown. See Scopes for what each scope allows.
  6. Click Create app
  7. Copy your app's client_id and client_secret and store them securely
Secure your client_secret

Treat your client secret like a password. Never share it with anyone outside your organization or expose it externally.

Your app is ready to use. Request an access token with the client credentials flow.

Your app works on live data from the start

Apps created in Carta go straight to production. There is no Playground step, so every request your app makes reads or changes your firm's or company's real data.

View your app's details and secret​

Every app with access to your firm or company is listed on the API access page. To see an app's details, open the actions menu (⋮) next to it and click View details. The details show the app's ID, name, organization, client ID, created date, description, and the data it can access.

For apps created in your firm or company, administrators can also click Show secret to reveal the client secret, or Copy secret to copy it. Secrets aren't shown for apps that were connected from the developer portal.

Delete the app​

You must be an administrator of the firm or company.

  1. On the API access page, open the actions menu (⋮) next to the app and click Delete app
  2. Click Delete app to confirm
Deleting an app is permanent

Any integration using the app's client credentials stops working immediately, and the app can't be restored. To give an integration access again, create a new app and update the integration with the new client_id and client_secret.

Apps connected from the developer portal can't be deleted from the API access page. Click Remove in their actions menu to take away their access to your data instead.