---
title: Phonovation V2 API - OAUTH
description: V2 of our InteractSMS API!
---

[Skip to content](https://knowledgebase.phonovation.com/oauth-api#main-content)

[More support](https://knowledgebase.phonovation.com/kb-tickets/new?hsLang=en)

[![Phonovation Logo (1)-1](https://knowledgebase.phonovation.com/hs-fs/hubfs/Phonovation%20Logo%20(1)-1.png?width=300&height=50&name=Phonovation%20Logo%20(1)-1.png)](https://www.phonovation.com/)

- [Phonovation](https://www.phonovation.com/)
- [Knowledgebase](https://knowledgebase.phonovation.com/)
- [Developer Portal](https://developers.phonovation.com/)

Open main navigation

Close main navigation

- [Phonovation](https://www.phonovation.com/)
- [Knowledgebase](https://knowledgebase.phonovation.com/)
- [Developer Portal](https://developers.phonovation.com/)
- [More support](https://knowledgebase.phonovation.com/kb-tickets/new)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Phonovation Knowledge Base](https://knowledgebase.phonovation.com/?hsLang=en)
2. [Phonovation API](https://knowledgebase.phonovation.com/phonovation-api?hsLang=en)
3. [Outbound Messages](https://knowledgebase.phonovation.com/phonovation-api?hsLang=en#outbound-messages)

January 20, 2026

# Phonovation V2 API - OAUTH

## This guide will show you details of our new OAUTH API! Please reach out to sales@phonovation.com to get setup!

🔐 Authentication – Getting Your Access Token

To interact with the Phonovation API, you must first obtain a **JWT access token** using the Auth API.

### 📌 Do Not Change `client_id` or `grant_type`

**Important:**  
When requesting a token, you **must always** send:

- `client_id=ismstoken`
- `grant_type=password`

These two values **must remain exactly as shown**. Only change the `username` and `password` fields.

### 🔑 Auth API Endpoint

`POST https://auth.interactsms.com/token`

#### Required Headers

- Content-Type: application/x-www-form-urlencoded

#### Request Body Example

```
grant_type=password
username=your_username
password=your_strong_password
client_id=ismstoken
```

#### Example Success Response

```
{
  "access_token": "eyJhbGciOi...",
  "expires_in": 120,
  "refresh_token": "eyJhbGciOi...",
  "token_type": "Bearer"
}
```

#### Authentication Header Example

```
Authorization: Bearer YOUR_ACCESS_TOKEN
```

 📤 Sending a Campaign – Phonovation API

Once authenticated, you can send SMS campaigns using the Phonovation API.

`POST https://api.interactsms.com/api/v2/Campaign`

#### Header

- Authorization: Bearer {access\_token}

#### Basic Campaign Payload

```
{  "text": "Come check out v2 of our API!!",  "from": "Phonovation",  "recipientInfo": [    {      "msisdn": "35386xxxxxxx"    }  ]}
```

#### Future Campaign Payload

```
{  "text": "Come check out v2 of our API!!",  "from": "Phonovation",  "recipientInfo": [    {      "msisdn": "35386xxxxxxx"    }  ],  "sendAt": "2030-03-28T20:00Z"}
```

#### Basic campaign with multiple Recipients and NotifyID

```
{  "text": "Come check out v2 of our API!!",  "from": "Phonovation",  "recipientInfo": [    {      "msisdn": "35386xxxxxxx",      "notifyId": "user-123"    },    {      "msisdn": "35387xxxxxxx",      "notifyId": "user-987"    }  ]}
```

#### Success Response

```
{
  "success": true,
  "message": "Campaign scheduled",
  "errors": []
}
```

 ✅ API Health Check

`GET https://api.interactsms.com/health`  
Response: `200 OK`

[mailto:support@phonovation.com](mailto:support@phonovation.com)

- [User Guides](https://knowledgebase.phonovation.com/user-guides?hsLang=en#main-content)

    - [Glossary](https://knowledgebase.phonovation.com/user-guides?hsLang=en#glossary)
    - [Technical Specifications](https://knowledgebase.phonovation.com/user-guides?hsLang=en#technical-specifications)
    - [Support](https://knowledgebase.phonovation.com/user-guides?hsLang=en#support)
    - [Account](https://knowledgebase.phonovation.com/user-guides?hsLang=en#account)
    - [Dashboard and UI](https://knowledgebase.phonovation.com/user-guides?hsLang=en#dashboard-and-ui)
    - [FAQ](https://knowledgebase.phonovation.com/user-guides?hsLang=en#faq)
- [Phonovation API](https://knowledgebase.phonovation.com/phonovation-api?hsLang=en#main-content)

    - [Guide](https://knowledgebase.phonovation.com/phonovation-api?hsLang=en#guide)
    - [Inbound/Incoming Messages](https://knowledgebase.phonovation.com/phonovation-api?hsLang=en#inbound-incoming-messages)
    - [Delivery Receipts / DLR's](https://knowledgebase.phonovation.com/phonovation-api?hsLang=en#delivery-receipts-dlrs)
    - [Outbound Messages](https://knowledgebase.phonovation.com/phonovation-api?hsLang=en#outbound-messages)
- [Campaign setup's](https://knowledgebase.phonovation.com/campaign-setups?hsLang=en#main-content)

    - [Setup](https://knowledgebase.phonovation.com/campaign-setups?hsLang=en#setup)
- [Campaign Management](https://knowledgebase.phonovation.com/campaign-management?hsLang=en#main-content)

    - [Lists (contacts)](https://knowledgebase.phonovation.com/campaign-management?hsLang=en#lists-contacts)
    - [Templates](https://knowledgebase.phonovation.com/campaign-management?hsLang=en#templates)
    - [Mobile Lookup](https://knowledgebase.phonovation.com/campaign-management?hsLang=en#mobile-lookup)
- [Billing and Costs](https://knowledgebase.phonovation.com/billing-and-costs?hsLang=en#main-content)

    - [Pricing](https://knowledgebase.phonovation.com/billing-and-costs?hsLang=en#pricing)
    - [Payment Methods](https://knowledgebase.phonovation.com/billing-and-costs?hsLang=en#payment-methods)
- [Support and Service](https://knowledgebase.phonovation.com/support-and-service?hsLang=en#main-content)

    - [Support / ServiceDesk](https://knowledgebase.phonovation.com/support-and-service?hsLang=en#support-servicedesk)
- [Features](https://knowledgebase.phonovation.com/features?hsLang=en#main-content)

    - [Smart Tags](https://knowledgebase.phonovation.com/features?hsLang=en#smart-tags)
- [SenderID's](https://knowledgebase.phonovation.com/senderids?hsLang=en#main-content)

    - [Comreg](https://knowledgebase.phonovation.com/senderids?hsLang=en#comreg)
- [HubSpot](https://knowledgebase.phonovation.com/hubspot?hsLang=en#main-content)

    - [Get Started](https://knowledgebase.phonovation.com/hubspot?hsLang=en#get-started)
    - [Workflow Actions](https://knowledgebase.phonovation.com/hubspot?hsLang=en#workflow-actions)
    - [Contact Card](https://knowledgebase.phonovation.com/hubspot?hsLang=en#contact-card)
    - [Timeline Activity](https://knowledgebase.phonovation.com/hubspot?hsLang=en#timeline-activity)
- [WhatsApp](https://knowledgebase.phonovation.com/whatsapp?hsLang=en#main-content)

    - [FAQ](https://knowledgebase.phonovation.com/whatsapp?hsLang=en#faq)

[![Phonovation-Logo-Light-RGB](https://knowledgebase.phonovation.com/hs-fs/hubfs/Official%20Branding/Phonovation-Logo-Light-RGB.png?width=350&height=63&name=Phonovation-Logo-Light-RGB.png "Phonovation-Logo-Light-RGB")](https://www.phonovation.com/)

**Phonovation Ltd.** Frascati Hall | Sweetman’s Avenue | Blackrock | Co. Dublin | A94 F9N7 | Ireland

<https://www.facebook.com/> <https://www.twitter.com/> <https://www.instagram.com/> [mailto:support@phonovation.com](mailto:support@phonovation.com)

Copyright © 2025, Phonovation Ltd.