ETERA API Documentation

Add a device token for push notifications. Tokens are automatically deduplicated.

AuthorizationBearer

JWT token obtained from authentication endpoints

This endpoint expects an object.

deviceTokenstringRequired

FCM token for Android, APNs token for iOS, or web push token

platformenumOptional

Platform type (optional, for metadata)

Allowed values:

Device token added successfully

successboolean

messagestring

deviceTokenslist of strings

Updated list of all device tokens

401

Unauthorized Error

1	const url = 'https://api.etera.dev/auth/device-tokens';
2	const options = {
3	method: 'POST',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{"deviceToken":"fGzQ9k4FmkE:APA91bH..."}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"success": true,
3	"message": "Device token added successfully",
4	"deviceTokens": [
5	"string"
6	]
7	}