Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Next challenges

Recent achievements

  • Global
  • Personal


  • Give kudos
  • Received
  • Given


  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Create branch - BitBucket REST API Support

I am trying to develope apapter for BitBucket Cloud using BitBucket REST API 2.0. 

My requirement is to create a new branch using API. But I am not able to find any API for that. However there is one API to GET branches but API to PUT a  branch is not there. Pls help.


Eric Henry Atlassian Team Jul 24, 2017


You can create a new branch using the 2.0 API as follows:

curl{repo_slug}/src/ --F "parents={parent_hash}" --F "branch={branch_name}"

You don't have to specify parents if you want the branch to be directly off the latest commit of the default branch, otherwise parents should be a hash to the commit that you want to create a branch off of.

Just an FYI: when you create a branch through the API it will create an empty commit (unless you also commit files when you create the branch).

Feel free to jump in to this HipChat room if you want some more "real-time support".

Development Team Lead, Bitbucket Cloud

Thanks for reply. Actually I was using Bibucket local server instance not the cloud one... but I guess the API would be same except the base url..

Has the API changed?

I'm getting {"type": "error", "error": {"message": "Something went wrong", "id": "b074e82335e948b897f5525a16c883ac"}} 500 when I post to this endpoint.




Ian Dick Atlassian Team May 11, 2018

Hi Tony. Do you mind if I ask what arguments you were passing to the API? You don't have to give me the specific values for repository or for the arguments I'm just wondering which arguments you are passing to the API.

@Tony Carter This issue has been identified and fixed. We appreciate the time you took to report it. The error response is very useful!

seanaty Atlassian Team Mar 05, 2019

@sergio ramos Unfortunately the APIs aren't the same. Please check out the server documentation here:


This works for me.. is there a way to modify the empty commit message in the request? It currently reads "Edited with Bitbucket".

Also, you mentioned "unless you also commit files when you create the branch" .. how would you do this via api when creating the branch?

Eric Henry Atlassian Team Nov 08, 2017

@blossm-steve-personal - Yes, you can specify a commit message and upload files at the same time.

See the API documentation for examples.

Let me know if the docs are clear enough.

Eric Henry
Development Team Lead, Bitbucket Cloud

For BB cloud, there are two ways:

1) This one will create a commit though, so your branch will be 1 commit ahead of your master...

curl -X POST -is -u user:pass{workspace}/{repo_slug}/src --form "parents=name_of_branch_to_create_from" --form "branch=name_of_branch_to_create"

2) This one will just create the branch:

curl -X POST -is -u user:pass -H 'Content-Type: application/json'{workspace}/{repo_slug}/refs/branches -d '{ "name": "name_of_branch_to_create", "target": { "hash": "name_of_branch_to_create_from" } }'

Have fun...

Like # people like this


Log in or Sign up to comment
Community showcase
Published in Bitbucket

Powering DevOps with Bitbucket Server & Data Center

Hi everyone, The Cloud team recently announced 12 new DevOps features that help developers ship better code, faster   ! While we’re all excited about the new improvements to Bitbucket ...

2,369 views 1 8
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you