Authenticate with the InteractSMS API using OAuth 2.0 JWT tokens.
Authorization header.
POST request to the auth server with your credentials:
curl -X POST https://auth.interactsms.com/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=password&client_id=ismstoken&username=YOUR_USERNAME&password=YOUR_PASSWORD"
{
"access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
"expires_in": 120,
"refresh_expires_in": 1200,
"refresh_token": "eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9...",
"token_type": "Bearer",
"scope": "email profile client_id"
}
access_token as a Bearer token in all API requests:
curl https://api.interactsms.com/api/v2/senderlist \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
| Token | Expiry |
|---|---|
access_token | 120 seconds |
refresh_token | 1200 seconds |
401 Unauthorized response and immediately re-authenticate with your credentials before retrying the request.
async function getToken() {
const res = await fetch('https://auth.interactsms.com/token', {
method: 'POST',
headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
body: new URLSearchParams({
grant_type: 'password',
client_id: 'ismstoken',
username: process.env.ISMSAPI_USERNAME,
password: process.env.ISMSAPI_PASSWORD
})
});
const { access_token } = await res.json();
return access_token;
}
async function apiRequest(path, options = {}) {
const token = await getToken();
const res = await fetch(`https://api.interactsms.com${path}`, {
...options,
headers: {
...options.headers,
Authorization: `Bearer ${token}`,
'Content-Type': 'application/json'
}
});
if (res.status === 401) throw new Error('Authentication failed');
return res.json();
}