POST

Add device token for user

Registers a new device token for the authenticated user. If the token already exists, updates its association or last set time as appropriate. Used for enabling push notifications to the user's device.

Header Params

request-id string

Body Params

object

deviceToken string required

at least 1 characters
provider string enum required

fcm
platform string enum required

ANDROIDIOS
appId string required

at least 1 characters

Responses

201

Device token added

Response Body

object

deviceToken string required
platform string enum required

ANDROIDIOS
provider string enum required

fcm
appId string required
bitgoUserId string required
message string required

400

Invalid device token request body

Response Body

object

Bad request error response

name string enum required

Error code

ValidationFailedIllegalArgumentBadRequestDataIntegrityErrorNotImplementedErrorRETRIGGER_RATE_LIMITEDUSER_CREATION_FAILEDUSER_FALLBACK_FAILED
error string required

Human-readable error message
status integer enum int32 required

HTTP status code

400

500

Unexpected error

Response Body

object

Internal server error response

name string enum required

Error code

UnexpectedErrorThirdPartyErrorDatabaseErrorUSER_FALLBACK_TIMEOUT
error string required

Human-readable error message
status integer enum int32 required

HTTP status code

500

curl --request POST \ --url 'https://app.bitgo-test.com/api/notifications/v1/tokens' \ --header 'accept: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \ --header 'request-id: string' \ --header 'content-type: application/json' \ --data '{,"deviceToken":"string","provider":"fcm","platform":"ANDROID","appId":"string"}'

const url = 'https://app.bitgo-test.com/api/notifications/v1/tokens'; const options = { method: 'POST', headers: {accept: 'application/json', 'Authorization': 'Bearer YOUR_ACCESS_TOKEN', 'request-id': 'string', 'content-type': 'application/json'}, body: JSON.stringify({,"deviceToken":"string","provider":"fcm","platform":"ANDROID","appId":"string"}) }; fetch(url, options) .then(res => res.json()) .then(json => console.log(json)) .catch(err => console.error(err));

require 'uri' require 'net/http' url = URI("https://app.bitgo-test.com/api/notifications/v1/tokens") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["accept"] = 'application/json' request["Authorization"] = 'Bearer YOUR_ACCESS_TOKEN' request["request-id"] = 'string' request["content-type"] = 'application/json' request.body = '{,"deviceToken":"string","provider":"fcm","platform":"ANDROID","appId":"string"}' response = http.request(request) puts response.read_body

<?php require_once('vendor/autoload.php'); $client = new \GuzzleHttp\Client(); $response = $client->request('POST', 'https://app.bitgo-test.com/api/notifications/v1/tokens', [ 'headers' => [ 'accept' => 'application/json', 'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', 'request-id' => 'string', 'content-type' => 'application/json', ], 'body' => '{,"deviceToken":"string","provider":"fcm","platform":"ANDROID","appId":"string"}', ]); echo $response->getBody();

import requests url = "https://app.bitgo-test.com/api/notifications/v1/tokens" payload = {,"deviceToken":"string","provider":"fcm","platform":"ANDROID","appId":"string"} headers = { "accept": "application/json", "Authorization": "Bearer YOUR_ACCESS_TOKEN", "request-id": "string", "content-type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.text)