[metadata]
og:image: https://sentry-docs-bpt555yka.sentry.dev/og.png
og:image:height: 630
og:image:width: 1200
og:title: Create a New Project
og:type: website
twitter:card: summary_large_image
twitter:image: https://sentry-docs-bpt555yka.sentry.dev/og.png
twitter:image:height: 630
twitter:image:width: 1200
twitter:title: Create a New Project
viewport: width=device-width, initial-scale=1
zd-site-verification: ocu6mswx6pke3c6qvozr2e

[canonical-links]
https://docs.sentry.io/api/projects/create-a-new-project/

[document-links]
AI: /ai/
API Reference: /api/
API: /api/
Add a Symbol Source to a Project: /api/projects/add-a-symbol-source-to-a-project/
Add a Team to a Project: /api/projects/add-a-team-to-a-project/
Authentication: /api/auth/
Create a New Client Key: /api/projects/create-a-new-client-key/
Create a New Project: /api/projects/create-a-new-project/
Create a Project for an Organization: /api/projects/create-a-project-for-an-organization/
Crons: /api/crons/
Dashboards: /api/dashboards/
Delete a Client Key: /api/projects/delete-a-client-key/
Delete a Project: /api/projects/delete-a-project/
Delete a Symbol Source from a Project: /api/projects/delete-a-symbol-source-from-a-project/
Delete a Team from a Project: /api/projects/delete-a-team-from-a-project/
Disable Spike Protection: /api/projects/disable-spike-protection/
Discover & Performance: /api/discover/
Docs: /
Enable Spike Protection: /api/projects/enable-spike-protection/
Environments: /api/environments/
Events & Issues: /api/events/
Explore: /api/explore/
Go to Sentry: https://sentry.io/
Guides: /guides/
Home: /
Integration Platform: /api/integration/
Integrations: /api/integrations/
Link a Repository to a Project: /api/projects/link-a-repository-to-a-project/
List a Project's Client Keys: /api/projects/list-a-projects-client-keys/
List a Project's Data Filters: /api/projects/list-a-projects-data-filters/
List a Project's Debug Information Files: /api/projects/list-a-projects-debug-information-files/
List a Project's Organization Members: /api/projects/list-a-projects-organization-members/
List a Project's Service Hooks: /api/projects/list-a-projects-service-hooks/
List a Project's User Feedback: /api/projects/list-a-projects-user-feedback/
List a Project's Users: /api/projects/list-a-projects-users/
List a Tag's Values: /api/projects/list-a-tags-values/
Mobile Builds: /api/mobile-builds/
Monitors & Alerts: /api/monitors/
Organizations: /api/organizations/
Paginating Results: /api/pagination/
Permissions & Scopes: /api/permissions/
Product Changelog: https://sentry.io/changelog/
Product: /product/
Profiling: /api/profiling/
Projects: /api/projects/
Rate Limits: /api/ratelimits/
Register a New Service Hook: /api/projects/register-a-new-service-hook/
Releases: /api/releases/
Remove a Service Hook: /api/projects/remove-a-service-hook/
Replays: /api/replays/
Requests: /api/requests/
Retrieve Event Counts for a Project: /api/projects/retrieve-event-counts-for-a-project/
Retrieve Ownership Configuration for a Project: /api/projects/retrieve-ownership-configuration-for-a-project/
Retrieve a Client Key: /api/projects/retrieve-a-client-key/
Retrieve a Project's Symbol Sources: /api/projects/retrieve-a-projects-symbol-sources/
Retrieve a Project: /api/projects/retrieve-a-project/
Retrieve a Service Hook: /api/projects/retrieve-a-service-hook/
SCIM: /api/scim/
SDKs: /platforms/
Sandbox: https://sandbox.sentry.io/
Seer: /api/seer/
Snapshots: /api/snapshots/
Spike Protection Notifications: /api/spike-protection/
Submit User Feedback: /api/projects/submit-user-feedback/
Teams: /api/teams/
Update Ownership Configuration for a Project: /api/projects/update-ownership-configuration-for-a-project/
Update a Client Key: /api/projects/update-a-client-key/
Update a Project's Symbol Source: /api/projects/update-a-projects-symbol-source/
Update a Project: /api/projects/update-a-project/
Update a Service Hook: /api/projects/update-a-service-hook/
Update an Inbound Data Filter: /api/projects/update-an-inbound-data-filter/
Users: /api/users/
authenticate via bearer auth token.: /api/auth/

[content]
Create a New Project
Skip to content
Docs
SDKs
Product
AI
Guides
Concepts
API
Manage
Ask AI
Go to Sentry
Open Main Menu
API Reference
Authentication
Paginating Results
Permissions & Scopes
Rate Limits
Requests
Crons
Dashboards
Discover & Performance
Environments
Events & Issues
Explore
Integration Platform
Integrations
Mobile Builds
Monitors & Alerts
Organizations
Profiling
Projects
Add a Symbol Source to a Project
Add a Team to a Project
Create a New Client Key
Create a New Project
Create a Project for an Organization
Delete a Client Key
Delete a Project
Delete a Symbol Source from a Project
Delete a Team from a Project
Disable Spike Protection
Enable Spike Protection
Link a Repository to a Project
List a Project's Client Keys
List a Project's Data Filters
List a Project's Debug Information Files
List a Project's Organization Members
List a Project's Service Hooks
List a Project's User Feedback
List a Project's Users
List a Tag's Values
Register a New Service Hook
Remove a Service Hook
Retrieve a Client Key
Retrieve a Project
Retrieve a Project's Symbol Sources
Retrieve a Service Hook
Retrieve Event Counts for a Project
Retrieve Ownership Configuration for a Project
Submit User Feedback
Update a Client Key
Update a Project
Update a Project's Symbol Source
Update a Service Hook
Update an Inbound Data Filter
Update Ownership Configuration for a Project
Releases
Replays
SCIM
Seer
Snapshots
Spike Protection Notifications
Teams
Users
Product Changelog
Sandbox
More
Home
API Reference
Projects
Create a New Project
Copy page
Create a New Project
POST
/api/0/teams/{organization_id_or_slug}/{team_id_or_slug}/projects/
Create a new project bound to a team.
Note: If your organization has disabled member project creation, the
org:write
or
team:admin
scope is required.
Path Parameters
organization_id_or_slug
(
string
)
REQUIRED
The ID or slug of the organization the resource belongs to.
team_id_or_slug
(
string
)
REQUIRED
The ID or slug of the team the resource belongs to.
Body Parameters
name
(
string
)
REQUIRED
The name for the project.
slug
(
string
)
Uniquely identifies a project and is used for the interface. If not provided, it is automatically generated from the name.
platform
(
string
)
The platform for the project.
default_rules
(
boolean
)
Defaults to true where the behavior is to alert the user on every new issue. Setting this to false will turn this off and the user must create their own alerts to be notified of new issues.
Scopes
You need to
authenticate via bearer auth token.
<auth_token>
requires one of the following scopes:
project:admin
project:write
Bash
Copied
curl
https://sentry.io/api/0/teams/
{
organization_id_or_slug
}
/
{
team_id_or_slug
}
/projects/
\
-H
'Authorization: Bearer <auth_token>'
\
-H
'Content-Type: application/json'
\
-d
'{}'
RESPONSE
SCHEMA
201
400
403
404
409
Copied
{
"team"
:
{
"id"
:
"2349234102"
,
"name"
:
"Prime Mover"
,
"slug"
:
"prime-mover"
}
,
"teams"
:
[
{
"id"
:
"2349234102"
,
"name"
:
"Prime Mover"
,
"slug"
:
"prime-mover"
}
,
{
"id"
:
"47584447"
,
"name"
:
"Powerful Abolitionist"
,
"slug"
:
"powerful-abolitionist"
}
]
,
"id"
:
"6758470122493650"
,
"slug"
:
"the-spoiled-yoghurt"
,
"name"
:
"The Spoiled Yoghurt"
,
"isBookmarked"
:
false
,
"isMember"
:
true
,
"access"
:
[
"project:read"
,
"event:read"
,
"team:read"
,
"alerts:read"
,
"org:read"
,
"event:write"
,
"project:releases"
,
"member:read"
]
,
"hasAccess"
:
true
,
"dateCreated"
:
"2023-03-29T15:25:21.344565Z"
,
"environments"
:
[
"production"
]
,
"features"
:
[
"alert-filters"
,
"custom-inbound-filters"
,
"discard-groups"
,
"minidump"
,
"rate-limits"
,
"servicehooks"
,
"similarity-indexing"
,
"similarity-indexing-v2"
,
"similarity-view"
,
"similarity-view-v2"
]
,
"firstEvent"
:
null
,
"firstTransactionEvent"
:
true
,
"hasSessions"
:
false
,
"hasProfiles"
:
false
,
"hasReplays"
:
false
,
"hasFlags"
:
false
,
"hasMonitors"
:
false
,
"hasFeedbacks"
:
false
,
"hasNewFeedbacks"
:
false
,
"hasMinifiedStackTrace"
:
false
,
"hasInsightsHttp"
:
true
,
"hasInsightsDb"
:
false
,
"hasInsightsAssets"
:
false
,
"hasInsightsAppStart"
:
false
,
"hasInsightsScreenLoad"
:
false
,
"hasInsightsVitals"
:
false
,
"hasInsightsCaches"
:
true
,
"hasInsightsQueues"
:
true
,
"hasInsightsAgentMonitoring"
:
false
,
"hasInsightsMCP"
:
false
,
"hasLogs"
:
false
,
"hasTraceMetrics"
:
false
,
"platform"
:
"node-express"
,
"platforms"
:
[
]
,
"latestRelease"
:
null
,
"hasUserReports"
:
false
,
"latestDeploys"
:
null
}
Was this helpful?
Yes 👍
No 👎
How can we improve this page?
Email
(optional)
Submit feedback
