Skip to main content
Creates a new repository. Note: In order to set the project for the newly created repository, pass in either the project key or the project UUID as part of the request body as shown in the examples below: 
$ curl -X POST -H "Content-Type: application/json" -d '{
    "scm": "git",
    "project": {
        "key": "MARS"
    }
}' https://api.bitbucket.org/2.0/repositories/teamsinspace/hablanding
or 
$ curl -X POST -H "Content-Type: application/json" -d '{
    "scm": "git",
    "project": {
        "key": "{ba516952-992a-4c2d-acbd-17d502922f96}"
    }
}' https://api.bitbucket.org/2.0/repositories/teamsinspace/hablanding
The project must be assigned for all repositories. If the project is not provided, the repository is automatically assigned to the oldest project in the workspace. Note: In the examples above, the workspace ID teamsinspace, and/or the repository name hablanding can be replaced by UUIDs.
External DocumentationTo learn more, visit the Bitbucket documentation.

​
Parameters

ParameterDescription
Default BranchA ref object, representing a branch or tag in a repository.
DescriptionA brief, informative description of the repository’s purpose and contents.
Fork PolicyControls the rules for forking this repository.

* allow_forks: unrestricted forking
* no_public_forks: restrict forking to private forks (forks cannot
be made public later)
* no_forks: deny all forking.
Has IssuesWhen checked, the issue tracker for this repository is enabled.

Note: Issue Tracker features are not supported for repositories in workspaces administered through admin.atlassian.com.
Has WikiSelect to enable the wiki for the repository.

Note: Wiki features are not supported for repositories in workspaces administered through admin.atlassian.com.
Is PrivateSelect to make the repository private, accessible only to explicitly granted users and teams.
LanguageThe primary programming language or technology used in the repository.
ProjectA Bitbucket project that the repository is a part of.
Projects are used by teams to organize repositories.

By default, uses the oldest project.
Repo NameSet a human-readable name for the repository.
Repo SlugThis can either be the repository slug or the UUID of the repository,
surrounded by curly-braces, for example: {repository UUID}.
Workspace SlugThis can either be the workspace ID (slug) or the workspace UUID
surrounded by curly-braces, for example: {workspace UUID}.

​
Example Output

{
	"type": "<string>",
	"full_name": "<string>",
	"links": {
		"self": {
			"href": "<string>"
		},
		"html": {
			"href": "<string>"
		},
		"avatar": {
			"href": "<string>"
		},
		"pullrequests": {
			"href": "<string>"
		},
		"commits": {
			"href": "<string>"
		},
		"forks": {
			"href": "<string>"
		},
		"watchers": {
			"href": "<string>"
		},
		"branches": {
			"href": "<string>"
		},
		"tags": {
			"href": "<string>"
		},
		"downloads": {
			"href": "<string>"
		},
		"source": {
			"href": "<string>"
		},
		"clone": [
			{
				"name": "<string>",
				"href": "<string>"
			},
			{
				"name": "<string>",
				"href": "<string>"
			}
		],
		"hooks": {
			"href": "<string>"
		}
	},
	"name": "<string>",
	"slug": "<string>",
	"description": "<string>",
	"scm": "<string>",
	"website": null,
	"owner": {
		"display_name": "<string>",
		"links": {
			"self": {
				"href": "<string>"
			},
			"avatar": {
				"href": "<string>"
			},
			"html": {
				"href": "<string>"
			}
		},
		"type": "<string>",
		"uuid": "<string>",
		"username": "<string>"
	},
	"workspace": {
		"type": "<string>",
		"uuid": "<string>",
		"name": "<string>",
		"slug": "<string>",
		"links": {
			"avatar": {
				"href": "<string>"
			},
			"html": {
				"href": "<string>"
			},
			"self": {
				"href": "<string>"
			}
		}
	},
	"is_private": false,
	"project": {
		"type": "<string>",
		"key": "<string>",
		"uuid": "<string>",
		"name": "<string>",
		"links": {
			"self": {
				"href": "<string>"
			},
			"html": {
				"href": "<string>"
			},
			"avatar": {
				"href": "<string>"
			}
		}
	},
	"fork_policy": "<string>",
	"created_on": "2025-04-02T05:13:55.790044+00:00",
	"updated_on": "2025-04-02T05:13:55.882094+00:00",
	"size": 2,
	"language": "<string>",
	"uuid": "<string>",
	"mainbranch": {
		"name": "<string>",
		"type": "<string>"
	},
	"override_settings": {
		"default_merge_strategy": true,
		"branching_model": true
	},
	"parent": null,
	"enforced_signed_commits": null
}

​
Workflow Library Example

Create Repository with Bitbucket and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop