How do I use the API tokens with Xcode?

[allenu]

I am unable to use the API token when configuring my Bitbucket Cloud account in Xcode. I was able to successfully create an API token but when I paste it into Xcode as the Password field for my account, I get an error that "Your account or password is incorrect". I was able to use the App Passwords just fine with Xcode but the API token doesn't work.

Can you help me get this working?

[Ben]

G'day Allen!

To start using API tokens - you'll need to create the API token and specify the scope - this is mentioned in our deprecation documentation:

1. Click the gear cog icon, select Atlassian Account settings > Security tab > Create and manage API Tokens

2. Click Create API token with scopes and select Bitbucket Cloud

3. If you want to be able to clone/push/pull to the repository - you'll need to tick both read:repository:bitbucket and write:repository:bitbucket - clone only would just be read:repository:bitbucket. More information on scopes can be found in our API scopes documentation.

4. Perform the clone using the API token by updating the remote URL in Xcode to either of the formats below - it should use Basic auth:

   https://username:APIToken@bitbucket.org/workspaceID/reposlug.git

https://x-bitbucket-api-token-auth:APIToken@bitbucket.org/workspaceID/reposlug.git

If you're still unable to use the API token, I'd recommend reaching out to the Xcode forums for further support:

• https://developer.apple.com/forums/topics/developer-tools-and-services/developer-tools-and-services-xcode

Cheers!

- Ben (Bitbucket Cloud Support)