Register Device for Push Notifications

This operation registers the push notifications token of the device/browser to the Registration set of a User with the corresponding `appName`. * If a User ID is not provided, a new User is created. * If a User ID is provided and the User exists, the device is registered to the User.

This operation registers the push notifications token of the device/browser to the Registration set of a User with the corresponding appName.

If a User ID is not provided, a new User is created.
If a User ID is provided and the User exists, the device is registered to the User.

Authentication

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Request

This endpoint expects an object.

appNamestringRequiredformat: "^[a-z0-9_]+$"1-64 characters

The name of the App to register the device for.

If the appName does not match the name of any existing Push Notification App, the operation will fail.

tokenstringRequired

The device token to register for push notifications.

providerenumRequired

Push notification service provider.

Allowed values:

userIdstringOptionalformat: "^comms_pushnotificationuser_[0-7][a-hjkmnpqrstv-z0-9]{25,34}"

The ID of the User to register the device to, if available.

Response headers

Locationstring

The location (uri) of the resource identified by Resource-Id.

Response

The request was accepted and a resource ID is available to check the result. The response body contains the resource ID and link to the resource.

resourceIdstring

The Resource ID is an identifier for the resource that was created or updated in response to the request.

resourceLocationstringformat: "uri"

The location (uri) of the resource identified by Resource-Id.

Errors

400

Bad Request Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error

This operation registers the push notifications token of the device/browser to the Registration set of a User with the corresponding appName.

If a User ID is not provided, a new User is created.
If a User ID is provided and the User exists, the device is registered to the User.

Basic authentication of the form Basic <base64(username:password)>.

This endpoint expects an object.

The name of the App to register the device for.

If the appName does not match the name of any existing Push Notification App, the operation will fail.

The device token to register for push notifications.

Push notification service provider.

The ID of the User to register the device to, if available.

The location (uri) of the resource identified by Resource-Id.

The request was accepted and a resource ID is available to check the result. The response body contains the resource ID and link to the resource.

The Resource ID is an identifier for the resource that was created or updated in response to the request.

The location (uri) of the resource identified by Resource-Id.

$	curl -X POST 'https://comms.twilio.com/preview/PushNotifications/DeviceRegistrations' \
>	--header 'Content-Type: application/json' \
>	--data '{
>	"userId": "comms_pushnotificationuser_01h9krwprkeee8fzqspvwy6nq8",
>	"appName": "limonade_app",
>	"token": "token",
>	"provider": "FCM"
>	}'\
>	-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

$	curl -X POST 'https://comms.twilio.com/preview/PushNotifications/DeviceRegistrations' \
>	--header 'Content-Type: application/json' \
>	--data '{
>	"userId": "comms_pushnotificationuser_01h9krwprkeee8fzqspvwy6nq8",
>	"appName": "limonade_app",
>	"token": "token",
>	"provider": "FCM"
>	}'\
>	-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

1	{
2	"resourceId": "comms_device_registration_01h9krwprkeee8fzqspvwy6nq8",
3	"resourceLocation": "https://comms.twilio.com/v1/PushNotifications/DeviceRegistrations/comms_device_registration_01h9krwprkeee8fzqspvwy6nq8"
4	}