openapi: 3.2.0
info:
description: This Service enables the Enterprise Customer to Add/Delete 10DLC numbers as well as Number Pools to Campaigns. The backend systems of this api will perform automatic MNO (Mobile Carrier) provisionning as required.
version: '1.2'
title: Syniverse 10DLC Provissioning 10DLC v1 Number Pools API
servers:
- url: https://api.syniverse.com
tags:
- name: 10DLC v1 Number Pools
description: Enhanced 10DLC Number Pool to Campaign Association Management
paths:
/engage/tendlc-services/v1/campaigns/{campaignId}/pools/{numberPoolId}/types/{numberPoolType}:
post:
security:
- Bearer: []
tags:
- 10DLC v1 Number Pools
summary: Association of Campaign with the Number Pool
description: Syniverse is required to update some MNO A2P platforms with the new Number Pool for a given campaign, enabling customers to better manage campaigns with large groups of numbers. Number pools require carrier approvals and this API currently covers 2 types SubId and CampaignId.
operationId: campaignWithNumberPoolAssociationUsingPOST
parameters:
- name: campaignId
in: path
description: campaignId
required: true
schema:
type: string
- name: numberPoolId
in: path
description: 'Number Pool Id that represents the Number Pool. Depending on the number pool type, it will be
USE:
- **{CampaignID}-{NNID}** for CampaignId Nmber Pool Type (exmple: CYYYYYY-999000)
- **{SubID}-{NNID}** for SubId Nmber Pool Type. (example CUST_SYN1-999000)'
required: true
schema:
type: string
- name: numberPoolType
in: path
description: Type of Number Pool based on SubId or based on Campaign Id; Indicative
required: true
schema:
type: string
enum:
- subId
- campaignId
- name: int-appId
in: header
description: int-appId for syniverse internal use only.
required: false
schema:
type: string
- name: int-companyId
in: header
description: int-companyId for syniverse internal use only.
required: false
schema:
type: string
responses:
'200':
description: Request recieved
content:
application/json:
schema:
type: string
'401':
description: You are not authorized to view the resource
'404':
description: The resource you were trying to reach is not found
deprecated: false
/engage/tendlc-services/v1/campaigns/{campaignId}/pools/{numberPoolId}:
delete:
security:
- Bearer: []
tags:
- 10DLC v1 Number Pools
summary: Removal of the Association of the Number pool from the Campaign
operationId: campaignWithNumberPoolRemovalUsingDELETE
parameters:
- name: campaignId
in: path
description: campaignId
required: true
schema:
type: string
- name: numberPoolId
in: path
description: 'Number Pool Id that represents the Number Pool. Depending on the number pool type, it will be
USE:
- **{CampaignID}-{NNID}** for CampaignId Nmber Pool Type (exmple: CYYYYYY-999000)
- **{SubID}-{NNID}** for SubId Nmber Pool Type. (example CUST_SYN1-999000)'
required: true
schema:
type: string
- name: int-appId
in: header
description: int-appId for syniverse internal use only.
required: false
schema:
type: string
- name: int-companyId
in: header
description: int-companyId for syniverse internal use only.
required: false
schema:
type: string
responses:
'200':
description: Request recieved
content:
application/json:
schema:
type: string
'401':
description: You are not authorized to view the resource
'404':
description: The resource you were trying to reach is not found
deprecated: false
components:
securitySchemes:
Bearer:
type: apiKey
name: Authorization
in: header
description: Use Bearer {Syniverse SDC Application Token} for example "Bearer aaaaa-aabb-bbaa-bbbbbb"