/subscriptions/1/subscription/SMS?applicationId=app1&applicationId=app2&resource=100200300400operationId: get-subscriptions parameters: - name: channel in: path description: Channel name. A separate subscription is needed for each channel. required: true style: simple explode: false schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SubscriptionChannel' - name: page in: query description: Results page to retrieve (0..N). required: false style: form explode: true schema: type: integer format: int32 default: 0 minimum: 0 - name: size in: query description: Number of records per page. required: false style: form explode: true schema: type: integer format: int32 default: 20 maximum: 100 minimum: 1 - name: applicationId in: query description: CPaaS-X application identifier. required: false style: form explode: true schema: type: string maxLength: 255 minLength: 1 - name: entityId in: query description: CPaaS-X entity identifier. required: false style: form explode: true schema: type: string maxLength: 255 minLength: 1 - name: callsConfigurationId in: query description: Calls configuration identifier. required: false style: form explode: true schema: type: string maxLength: 128 minLength: 1 - name: resource in: query description: Resource. required: false style: form explode: true schema: type: string maxLength: 255 minLength: 1 - name: user in: query description: User. required: false style: form explode: true schema: type: string maxLength: 255 minLength: 1 responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SubscriptionPage' '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage post: tags: - platform summary: Create subscription description: This method will create a new subscription. You can provide an ID of an existing profile, or submit a full definition of a profile and security settings if you want to create new ones. operationId: create-subscription parameters: - name: channel in: path description: Channel name. A separate subscription is needed for each channel. required: true style: simple explode: false schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SubscriptionChannel' requestBody: content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SubscriptionRequest' examples: Request example: summary: Request example value: subscriptionId: ABC-123-DEF name: Default group events: - DELIVERY criteria: - applicationId: production entityId: entity1 - applicationId: production entityId: entity2 - applicationId: test entityId: entity1 resources: - '1234' users: - user1 - user2 profile: profileId: NOTIF-32395 webhook: notifyUrl: https://www.example.com/pushme security: authId: NEWAUTH-9291 type: BASIC credentials: username: user1 password: password1 required: true responses: '201': description: Created. headers: Location: description: Resource location. style: simple explode: false schema: type: string content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlySubscriptionResponse' '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage /subscriptions/1/subscription/{channel}/{subscriptionId}: get: tags: - platform summary: Get single subscription description: Returns a specific subscription by ID. operationId: get-subscription parameters: - name: subscriptionId in: path description: ID of the subscription you want to get. required: true style: simple explode: false schema: type: string - name: channel in: path description: Channel name. A separate subscription is needed for each channel. required: true style: simple explode: false schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SubscriptionChannel' responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SubscriptionResponse' examples: Response example: summary: Response example value: subscriptionId: ABC-123-DEF name: Default group profile: profileId: NOTIF-32395 security: authId: NEWAUTH-9291 events: - DELIVERY criteria: - applicationId: production entityId: entity1 - applicationId: production entityId: entity2 - applicationId: test entityId: entity1 resources: - '1234' users: - user1 - user2 Set new profile for group response example: summary: Set new profile for group response example value: subscriptionId: ABC-123-DEF name: Default group profile: profileId: NOTIF-12345 security: authId: NEWAUTH-9291 events: - DELIVERY criteria: - applicationId: production entityId: entity1 - applicationId: production entityId: entity2 - applicationId: test entityId: entity1 resources: - '1234' users: - user1 - user2 Edit group and switch profile response example: summary: Edit group and switch profile response example value: subscriptionId: ABC-123-DEF name: Updated group profile: profileId: NOTIF-98765 security: authId: NEWAUTH-9999 events: - DELIVERY criteria: - applicationId: production entityId: entity1 - applicationId: production entityId: entity2 - applicationId: test entityId: entity1 resources: - '1234' users: - user1 - user2 '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage put: tags: - platform summary: Update subscription description: This method allows you to update the subscription. You can change its properties and provide an ID of a profile if you wish to change it. operationId: update-subscription parameters: - name: subscriptionId in: path description: ID of the subscription you want to modify. required: true style: simple explode: false schema: type: string - name: channel in: path description: Channel name. A separate subscription is needed for each channel. required: true style: simple explode: false schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SubscriptionChannel' requestBody: content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.NoIdSubscriptionRequest' examples: Request example: summary: Request example value: name: Updated group profile: profileId: NOTIF-98765 events: - DELIVERY criteria: - applicationId: production entityId: entity1 - applicationId: production entityId: entity2 - applicationId: test entityId: entity1 resources: - '1234' users: - user1 - user2 required: true responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlySubscriptionResponse' examples: Response example: summary: Response example value: subscriptionId: ABC-123-DEF profile: profileId: NOTIF-32395 security: authId: NEWAUTH-9291 '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage delete: tags: - platform summary: Delete subscription description: This method will delete the subscription specified by ID. operationId: delete-subscription parameters: - name: subscriptionId in: path description: ID of the subscription you want to delete. required: true style: simple explode: false schema: type: string - name: channel in: path description: Channel name. A separate subscription is needed for each channel. required: true style: simple explode: false schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SubscriptionChannel' responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlySubscriptionResponse' examples: Response example: summary: Response example value: subscriptionId: ABC-123-DEF profile: profileId: NOTIF-32395 security: authId: NEWAUTH-9291 '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage /subscriptions/1/profiles: get: tags: - platform summary: Get notification profiles description: Returns a list of all notification profiles for your account with pagination. operationId: get-profiles parameters: - name: page in: query description: Results page to retrieve (0..N). required: false style: form explode: true schema: type: integer format: int32 default: 0 minimum: 0 - name: size in: query description: Number of records per page. required: false style: form explode: true schema: type: integer format: int32 default: 20 maximum: 100 minimum: 1 responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfilePage' '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage post: tags: - platform summary: Create notification profile description: This method will create a new notification profile. You can provide an ID of existing security settings if you wish to reuse them or submit full definition, if you want to create a new one. operationId: create-profile requestBody: content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfileRequest' examples: Request example: summary: Request example value: profileId: NOTIF-32395 webhook: notifyUrl: https://www.example.com/pushme security: authId: NEWAUTH-9291 type: BASIC credentials: username: user1 password: password1 clientCertificateId: MYCERT-1337 maxBucketSize: 1 windowSize: 20 connectTimeout: 10000 readTimeout: 10000 enabledSSLProtocols: - TLSv1.3 - TLSv1.2 headers: X-Important-Header: Important Value responseRegex: '[1-9][0-9]' responseBodyRegex: '[1-9][0-9]' rateLimit: 5000 required: true responses: '201': description: Created. headers: Location: description: Resource location. style: simple explode: false schema: type: string content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyProfileResponse' '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage /subscriptions/1/profiles/{profileId}: get: tags: - platform summary: Get single notification profile description: Returns a specific notification profile by ID. operationId: get-profile parameters: - name: profileId in: path description: Notification profile ID. required: true style: simple explode: false schema: type: string responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfileResponse' examples: Response example: summary: Response example value: profileId: NOTIF-32395 webhook: contentType: application/json notifyUrl: https://www.example.com/pushme security: authId: NEWAUTH-9291 maxBucketSize: 1 windowSize: 20 connectTimeout: 10000 readTimeout: 10000 enabledSSLProtocols: - TLSv1.3 - TLSv1.2 headers: X-Important-Header: Important Value responseRegex: '[1-9][0-9]' responseBodyRegex: '[1-9][0-9]' rateLimit: 5000 '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage put: tags: - platform summary: Update notification profile description: This method allows you to update a notification profile. You can change its properties and provide an ID of security settings if you wish to change them. operationId: update-profile parameters: - name: profileId in: path required: true style: simple explode: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.NoIdProfileRequest' examples: Set new security for an existing profile request example: summary: Set new security for an existing profile request example value: webhook: notifyUrl: https://www.example.com/pushme security: authId: AUTH-123 maxBucketSize: 1 windowSize: 20 connectTimeout: 10000 readTimeout: 10000 enabledSSLProtocols: - TLSv1.3 - TLSv1.2 headers: X-Important-Header: Important Value responseRegex: '[1-9][0-9]' responseBodyRegex: '[1-9][0-9]' rateLimit: 5000 required: true responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyProfileResponse' examples: Response example: summary: Response example value: profileId: NOTIF-32395 security: authId: NEWAUTH-9291 '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage delete: tags: - platform summary: Delete notification profile description: This method will delete a notification profile specified by ID. operationId: delete-profile parameters: - name: profileId in: path description: Notification profile ID. required: true style: simple explode: false schema: type: string responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyProfileResponse' examples: Response example: summary: Response example value: profileId: NOTIF-32395 security: authId: NEWAUTH-9291 '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage /subscriptions/1/security: get: tags: - platform summary: Get security settings description: Returns a list of security settings for your account with pagination. operationId: get-security-settings parameters: - name: page in: query description: Results page to retrieve (0..N). required: false style: form explode: true schema: type: integer format: int32 default: 0 minimum: 0 - name: size in: query description: Number of records per page. required: false style: form explode: true schema: type: integer format: int32 default: 20 maximum: 100 minimum: 1 responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SecurityPage' '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage post: tags: - platform summary: Create security settings description: This method will create new security settings. operationId: create-security-settings requestBody: content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SecurityRequest' examples: Request example: summary: Request example value: authId: NEWAUTH-9291 type: BASIC credentials: username: user1 password: password1 required: true responses: '201': description: Created. headers: Location: description: Resource location. style: simple explode: false schema: type: string content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlySecurityResponse' '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage /subscriptions/1/security/{authId}: get: tags: - platform summary: Get single security settings description: Returns specific security settings item by ID. operationId: get-security-setting parameters: - name: authId in: path description: Security settings ID. required: true style: simple explode: false schema: type: string responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SecurityResponse' examples: Response example: summary: Response example value: authId: NEWAUTH-9291 type: BASIC credentials: username: user1 password: password1 '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage put: tags: - platform summary: Update security settings description: This method allows you to update the security settings. operationId: update-security-settings parameters: - name: authId in: path required: true style: simple explode: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.NoIdSecurityRequest' examples: Update request example: summary: Update request example value: type: BASIC credentials: username: user1 password: password1 required: true responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlySecurityResponse' examples: Response example: summary: Response example value: authId: NEWAUTH-9291 '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage delete: tags: - platform summary: Delete security settings description: This method will delete the security settings item by ID. operationId: delete-security-settings parameters: - name: authId in: path description: Security settings ID. required: true style: simple explode: false schema: type: string responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlySecurityResponse' examples: Response example: summary: Response example value: authId: NEWAUTH-9291 '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': description: Too many requests. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: TOO_MANY_REQUESTS text: Too many requests '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage /subscriptions/1/certificates: get: tags: - platform summary: Get filtered certificate details page description: Returns a page containing certificates details by filtering condition. operationId: get-certificates-details-page parameters: - name: search in: query description: Search filter. Limits returned results. required: false style: form explode: true schema: type: string - name: page in: query description: Results page to retrieve (0..N). required: false style: form explode: true schema: type: integer format: int32 default: 0 minimum: 0 - name: size in: query description: Number of records per page. required: false style: form explode: true schema: type: integer format: int32 default: 20 maximum: 100 minimum: 1 - name: sortBy in: query description: Sorting parameter. required: false style: form explode: true schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CertificatesSortType' - name: direction in: query description: Sorting direction. required: false style: form explode: true schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SortDirection' responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CertificateDetailsPage' examples: Response example: summary: Response example value: results: - certificateId: my-certificate-1 issuedBy: CN=Issuer LTD.,DC=abc,DC=issuer,DC=com issuedTo: CN=subject.domain.com,O=Subject LTD.,L=Vodnjan,ST=Istria,C=HR validFrom: 1655683200000 validUntil: 1687219200000 certificateStatus: READY serialNumber: '1605653657727226303992554724456686612151129941' paging: page: 0 size: 1 totalPages: 1 totalResults: 1 '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': $ref: '#/components/responses/ApiException429' '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage x-throttling-info: - type: time numberOfRequests: 100 numberOfTimeUnits: 0 timeUnit: m post: tags: - platform summary: Upload certificate description: Upload the certificate Infobip will present for your webhook to verify Infobip when sending notification events. operationId: upload-certificate requestBody: content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CertificateUploadRequest' examples: Request example: summary: Request example value: certificateId: my-certificate-1 certificateContent: IyBQcml2YXRlIGtleSBvZiB0aGUgU1NMIGNlcnRpZmljYXRlCi0tLS0tQkVHSU4gUFJJVkFURSBLRVktLS0tLQpNSUlFdmdJQkFEQU5CZ2txaGtpRzl3MEJBUUVGQUFTQ0JLZ3dnZ1NrQWdFQUFvSUJBUURCajA4c3A1Kys0YW5HCmNtUXhKakFrQmdOVkJBb1RIVkJ5YjJkeVpYTnpJRk52Wm5SM1lYSmxJRU52Y25CdmNtRjBhVzl1TVNBd0hnWUQKVlFRRERCY3FMbUYzY3kxMFpYTjBMbkJ5YjJkeVpYTnpMbU52YlRDQ0FTSXdEUVlKS29aSWh2Y05BUUVCQlFBRAouLi4KYm1sNllYUnBiMjUyWVd4emFHRXlaekl1WTNKc01JR2dCZ2dyQmdFRkJRY0JBUVNCa3pDQmtEQk5CZ2dyQmdFRgpCUWN3QW9aQmFIUjBjRG92TDNObFkzVnlaUzVuYkc5aVlXeHphV2R1TG1OdmJTOWpZV05sY25RdlozTnZjbWRoCnozUDY2OFlmaFViS2RSRjZTNDJDZzZ6bgotLS0tLUVORCBQUklWQVRFIEtFWS0tLS0tCgojIFB1YmxpYyBrZXkgb2YgdGhlIFNTTCBjZXJ0aWZpY2F0ZSAodGhlIHNlcnZlciBjZXJ0aWZpY2F0ZSkKLS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUZhRENDQkZDZ0F3SUJBZ0lTRVNIa3ZaRndLOVF6MEtzWEQzeDhwNDRhTUEwR0NTcUdTSWIzRFFFQkN3VUEKVlFRRERCY3FMbUYzY3kxMFpYTjBMbkJ5YjJkeVpYTnpMbU52YlRDQ0FTSXdEUVlKS29aSWh2Y05BUUVCQlFBRApnZ0VQQURDQ0FRb0NnZ0VCQU1HUFR5eW5uNzdocWNZbmpXc013T1pEemRoVkZZOTNzMk9KbnRNYnVLVEhuMzlCCi4uLgpibWw2WVhScGIyNTJZV3h6YUdFeVp6SXVZM0pzTUlHZ0JnZ3JCZ0VGQlFjQkFRU0JrekNCa0RCTkJnZ3JCZ0VGCkJRY3dBb1pCYUhSMGNEb3ZMM05sWTNWeVpTNW5iRzlpWVd4emFXZHVMbU52YlM5allXTmxjblF2WjNOdmNtZGgKYm1sNllYUnBiMjUyWVd4emFHRXlaekp5TVM1amNuUXdQd1lJS3dZQkJRVUhNQUdHTTJoMGRIQTZMeTl2WTNOdwpsZmZ5Z0Q1SXltQ1N1dURpbTRxQi85Ymg3b2kzN2hlSjRPYnBCSXpyb1BVT3RoYkc0Z3YvNWJsVzNEYz0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQoKIyBUcnVzdCBjaGFpbiBpbnRlcm1lZGlhdGUgY2VydGlmaWNhdGUKLS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUVhVENDQTFHZ0F3SUJBZ0lMQkFBQUFBQUJSRTd3UWtjd0RRWUpLb1pJaHZjTkFRRUxCUUF3VnpFTE1Ba0cKQzMzSmlKMVBpL0Q0bkd5TVZUWGJ2L0t6NnZ2alZ1ZEtSdGtUSXNvMjFadkJxT09XUTVQeURMem0rZWJvbWNoagpTSGgvVnpacEdoa2RXdEhVZmNLYzFIL2hnQkt1ZXVxSTZsZll5Z29LT2hKSm9tSVplZzBrOXpmcnRIT1Nld1VqCi4uLgpkSEJ6T2k4dmQzZDNMbWRzYjJKaGJITnBaMjR1WTI5dEwzSmxjRzl6YVhSdmNua3ZNRE1HQTFVZEh3UXNNQ293CktLQW1vQ1NHSW1oMGRIQTZMeTlqY213dVoyeHZZbUZzYzJsbmJpNXVaWFF2Y205dmRDNWpjbXd3UFFZSUt3WUIKSzFwcDc0UDFTOFNxdENyNGZLR3hoWlNNOUF5SERQU3NRUGhaU1pnPQotLS0tLUVORCBDRVJUSUZJQ0FURS0tLS0tCgojIFRydXN0IGNoYWluIHJvb3QgY2VydGlmaWNhdGUKLS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSURkVENDQWwyZ0F3SUJBZ0lMQkFBQUFBQUJGVXRhdzVRd0RRWUpLb1pJaHZjTkFRRUZCUUF3VnpFTE1Ba0cKWVd4VGFXZHVJRzUyTFhOaE1SQXdEZ1lEVlFRTEV3ZFNiMjkwSUVOQk1Sc3dHUVlEVlFRREV4SkhiRzlpWVd4VAphV2R1SUZKdmIzUWdRMEV3Z2dFaU1BMEdDU3FHU0liM0RRRUJBUVVBQTRJQkR3QXdnZ0VLQW9JQkFRRGFEdWFaCi4uLgpqYzZqNDArS2Z2dnhpNE1sYStwSUgvRXFzTG1WRVFTOThHUFI0bWRtenh6ZHp4dElLKzZOaVk2YXJ5bUFaYXZwCjM4TmZsTlVWeVJSQm5NUmRkV1FWRGY5Vk1PeUdqLzhON3l5NVkwYjJxdnpmdkduOUxoSklaSnJnbGZDbTd5bVAKSE1VZnBJQnZGU0RKM2d5SUNoM1dabFhpL0VqSktTWnA0QT09Ci0tLS0tRU5EIENFUlRJRklDQVRFLS0tLS0= passphrase: TXk1dHJvbmdAUGE1NXBocmE1MyE= required: true responses: '201': description: Created. headers: Location: description: Resource location. style: simple explode: false schema: type: string format: uri content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CertificateStatusResponse' '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': $ref: '#/components/responses/ApiException429' '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage x-throttling-info: - type: time numberOfRequests: 100 numberOfTimeUnits: 0 timeUnit: m /subscriptions/1/certificates/{certificateId}: get: tags: - platform summary: Get certificate details by identifier description: Returns a certificate details. operationId: get-certificate-details parameters: - name: certificateId in: path description: Certificate identifier. required: true style: simple explode: false schema: type: string maxLength: 255 minLength: 1 responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CertificateDetailsResponse' '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': $ref: '#/components/responses/ApiException429' '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage x-throttling-info: - type: time numberOfRequests: 100 numberOfTimeUnits: 0 timeUnit: m delete: tags: - platform summary: Delete certificate description: Deletes an existing certificate by a given identifier. Note, certificates cannot be deleted if linked to a Notification Profile. operationId: delete-certificate parameters: - name: certificateId in: path description: Certificate identifier. required: true style: simple explode: false schema: type: string maxLength: 255 minLength: 1 responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyCertificateResponse' examples: Response example: summary: Response example value: certificateId: my-certificate-1 '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': $ref: '#/components/responses/ApiException429' '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage x-throttling-info: - type: time numberOfRequests: 100 numberOfTimeUnits: 0 timeUnit: m /subscriptions/1/certificates/status: get: tags: - platform summary: Get filtered certificates statuses page description: Returns a page containing certificates statuses by filtering condition. operationId: get-certificates-statuses-page parameters: - name: search in: query description: Search filter. Limits returned results. required: false style: form explode: true schema: type: string - name: page in: query description: Results page to retrieve (0..N). required: false style: form explode: true schema: type: integer format: int32 default: 0 minimum: 0 - name: size in: query description: Number of records per page. required: false style: form explode: true schema: type: integer format: int32 default: 20 maximum: 100 minimum: 1 - name: sortBy in: query description: Sorting parameter. required: false style: form explode: true schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CertificatesSortType' - name: direction in: query description: Sorting direction. required: false style: form explode: true schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SortDirection' responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CertificateStatusPage' examples: Response example: summary: Response example value: results: - certificateId: my-certificate-1 status: READY - certificateId: my-certificate-2 status: PROCESSING - certificateId: my-certificate-3 status: EXPIRED paging: page: 0 size: 3 totalPages: 1 totalResults: 3 '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': $ref: '#/components/responses/ApiException429' '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage x-throttling-info: - type: time numberOfRequests: 100 numberOfTimeUnits: 0 timeUnit: m /subscriptions/1/certificates/status/{certificateId}: get: tags: - platform summary: Get certificate status by identifier description: Returns a certificate status. operationId: get-certificate-status parameters: - name: certificateId in: path description: Certificate identifier. required: true style: simple explode: false schema: type: string maxLength: 255 minLength: 1 responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CertificateStatusResponse' '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': $ref: '#/components/responses/ApiException429' '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage x-throttling-info: - type: time numberOfRequests: 100 numberOfTimeUnits: 0 timeUnit: m /subscriptions/1/certificates/test/webhook: post: tags: - platform summary: Test connection to a webhook description: Performs connectivity check to provided webhook with the given certificate. Note, it does not send a notification event. operationId: test-connection-to-webhook requestBody: content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CertificateConnectionTestRequest' examples: Request example: summary: Request example value: certificateId: my-certificate-1 webhookUrl: https://example.com/webhook-url required: true responses: '200': description: Success. content: application/json: schema: $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CertificateConnectionTestResponse' examples: Response example: summary: Response example value: certificateId: my-certificate-1 webhookUrl: https://example.com/my-webhook result: SUCCESS '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: field: - field must not be null Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/d20db567f3e57223af6c81b075b50f0bc0d564bb5690e0ef2603138160aca7f3.ApiException' examples: Error responses: summary: Error responses description: Error responses value: requestError: serviceException: messageId: NOT_FOUND text: Not found '429': $ref: '#/components/responses/ApiException429' '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - subscriptions:manage x-throttling-info: - type: time numberOfRequests: 100 numberOfTimeUnits: 0 timeUnit: m /metrics/1/query-aggregate-data: post: tags: - platform summary: Query aggregated traffic data description: Start process for traffic data aggregation. The result will be posted to `callbackURL` provided in the request. The response format is described in [Receive aggregated data result](#platform/metrics-api/receive-aggregate-data-result) operation. operationId: query-aggregate-data requestBody: content: application/json: schema: $ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.QueryAggregateDataRequest' examples: A simple request: summary: A simple request value: callbackUrl: https://example.com/receive request: filterBy: accountKeys: - 565C2852060F94BC771F692C04C055E1 includeSubaccounts: true sentSince: 2023-04-01T00:00:00.000+0000 sentUntil: 2023-04-01T01:00:00.000+0000 channelCodes: - SMS directions: - OUTBOUND communicationIds: - 12354646546 - 45534466546 - 754564654689 campaignReferenceIds: - CAMPAIGNNAME-20240612-001 - CAMPAIGNNAME-20240612-002 entityId: '' statusGroups: - REJECTED - UNDELIVERABLE statuses: - UNDELIVERABLE_REJECTED_OPERATOR - REJECTED_NETWORK - REJECTED_SENDER errorGroups: - OPERATOR_ERRORS - USER_ERRORS errorCodes: - NO_ERROR - EC_UNKNOWN_SUBSCRIBER - EC_UNKNOWN_BASE_STATION aggregateBy: - ACCOUNT_KEY - HOUR - DIRECTION - STATUS metrics: - TOTAL_TRAFFIC_COUNT Request using multiple date/time aggregates: summary: Request using multiple date/time aggregates description: When using multiple date/time aggregates, only the finest one will be presented in the response. In this case, when one queries for DAY and HOUR, only HOUR will be present. value: callbackUrl: https://example.com/receive request: filterBy: accountKeys: - 565C2852060F94BC771F692C04C055E1 includeSubaccounts: false sentSince: 2023-04-01T00:00:00.000+0000 sentUntil: 2023-04-01T01:00:00.000+0000 channelCodes: - SMS entityId: '' aggregateBy: - DAY - HOUR - STATUS metrics: - TOTAL_TRAFFIC_COUNT required: true responses: '201': description: Data querying process is started. content: application/json: schema: $ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.QueryAggregateDataResponse' examples: A successful response: summary: A successful response value: requestId: B61D150B0F6596F68D88D253886432B5 '400': description: Request is malformed or invalid. content: application/json: schema: $ref: '#/components/schemas/ApiError' examples: Bad request: summary: Bad request value: errorCode: E400 description: Request cannot be processed. action: Check the syntax, violations and adjust the request. violations: - property: property.path violation: Violation message. resources: [] '401': $ref: '#/components/responses/ApiError401' '403': $ref: '#/components/responses/ApiError403' '429': $ref: '#/components/responses/ApiError429' '500': $ref: '#/components/responses/ApiError500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - metrics:manage x-is-early-access: true x-throttling-info: - type: time numberOfRequests: 60 numberOfTimeUnits: 0 timeUnit: s /metrics/1/requests/{requestId}: get: tags: - platform summary: Get status of query aggregate data request description: Return the status of ongoing request, started by invoking [Query aggregated traffic data](#platform/metrics-api/query-aggregate-data). operationId: get-aggregate-request-status parameters: - name: requestId in: path required: true style: simple explode: false schema: type: string responses: '200': description: Request status retrieved. content: application/json: schema: $ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.RequestInfo' '401': $ref: '#/components/responses/ApiError401' '403': $ref: '#/components/responses/ApiError403' '404': description: Request with provided id not found. content: application/json: schema: $ref: '#/components/schemas/ApiError' examples: Not found: summary: Not found value: errorCode: E404 description: Not found - request URL doesn't exist on the API server or resource is not found. action: Check the resources and adjust your request. violations: - property: requestId violation: Request with id "B61D150B0F6596F68D88D253886432B5" not found resources: [] '429': $ref: '#/components/responses/ApiError429' '500': $ref: '#/components/responses/ApiError500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - metrics:manage x-is-early-access: true x-throttling-info: - type: time numberOfRequests: 60 numberOfTimeUnits: 0 timeUnit: s /billing/1/usage/query: post: tags: - platform summary: Query billing usage data description: Start the process of aggregating billing-grade financial cost data for your Infobip traffic. The results are delivered once via POST to the `callbackURL` provided in the request. Make sure the URL is reachable before submitting. See [Receive billing usage result](#platform/billing-usage/receive-billing-usage-result) for the webhook payload structure. operationId: query-billing-usage requestBody: content: application/json: schema: $ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.QueryBillingUsageRequest' examples: A simple billing usage request: summary: A simple billing usage request value: callbackUrl: https://example.com/receive request: filterBy: dateInterval: sentSince: '2026-03-01' sentUntil: '2026-04-01' aggregateBy: - CATEGORY_CODE - COUNTRY_NAME options: includeUnfinalizedData: true A detailed billing usage request: summary: A detailed billing usage request value: callbackUrl: https://example.com/webhooks/billing-usage request: filterBy: dateInterval: sentSince: '2026-03-01' sentUntil: '2026-04-01' categories: - SMS - WHATSAPP - RCS platforms: - applicationId: app_a entityId: entity_a - applicationId: app_a entityId: entity_b - applicationId: app_b entityId: entity_a directions: - OUTBOUND campaignReferenceIds: - campaign_ref_1 - campaign_ref_2 - campaign_ref_3 aggregateBy: - APPLICATION_ID - ENTITY_ID - CATEGORY_CODE - COUNTRY_NAME - TRAFFIC_TYPE - SENDER_TYPE - ACCOUNT_KEY options: includeUnfinalizedData: true required: true responses: '201': description: Data querying process is started. content: application/json: schema: $ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.QueryAggregateDataResponse' examples: A successful response: summary: A successful response value: requestId: B61D150B0F6596F68D88D253886432B5 '400': description: Request is malformed or invalid. content: application/json: schema: $ref: '#/components/schemas/ApiError' examples: Bad request: summary: Bad request value: errorCode: E400 description: Request cannot be processed. action: Check the syntax, violations and adjust the request. violations: - property: property.path violation: Violation message. resources: [] '401': $ref: '#/components/responses/ApiError401' '403': $ref: '#/components/responses/ApiError403' '429': $ref: '#/components/responses/ApiError429' '500': $ref: '#/components/responses/ApiError500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - billing:usage:view x-is-early-access: true x-throttling-info: - type: time numberOfRequests: 60 numberOfTimeUnits: 0 timeUnit: s /provisioning/2/sending-strategies: get: tags: - platform summary: Get sending strategies description: Get sending strategies. operationId: get-sending-strategies-v2 parameters: - name: sendingStrategyId in: query description: Id of created Sending Strategy. required: false style: form explode: true schema: type: string example: 78D8394AC3EG0460B4CF0E723FC31B49 - name: applicationId in: query description: Application Id of created Sending Strategy. For more details, see the [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management). required: false style: form explode: true schema: type: string example: test-application-1 - name: entityId in: query description: Entity Id of created Sending Strategy. For more details, see the [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management). required: false style: form explode: true schema: type: string example: test-entity-1 - name: page in: query description: Requested page number. required: false style: form explode: true schema: type: integer default: 0 example: 0 minimum: 0 - name: size in: query description: Requested page size. required: false style: form explode: true schema: type: integer default: 100 example: 10 maximum: 1000 minimum: 1 responses: '200': description: OK. content: application/json: schema: $ref: '#/components/schemas/5929f45c31f06c29ab1bc6e26caa01575484225e5ef99a2512bee829b646f1c1.PageResponse' examples: Response example: summary: Response example value: results: - sendingStrategyId: 78D8394AC3EG0460B4CF0E723FC31B49 platform: entityId: test-entity-1 applicationId: test-application-1 channel: MMS destinationCountryCode: US useStickySender: false useGeolocatedSender: true priorities: - senderType: VIRTUAL_LONG_NUMBER priority: 1 - senderType: TOLL_FREE_NUMBER priority: 2 - sendingStrategyId: 3B9D1EACAB7FBDRN4EE03592BFCD6BE1 platform: entityId: test-entity-2 applicationId: test-application-2 useStickySender: false useGeolocatedSender: false - sendingStrategyId: 712D1EACAB7FDORN4EE035954FCD6BOO platform: entityId: test-entity-2 applicationId: test-application-3 useStickySender: true useGeolocatedSender: false paging: page: 0 size: 10 totalPages: 1 totalResults: 3 '401': $ref: '#/components/responses/ApiError401' '403': $ref: '#/components/responses/ApiError403' '429': $ref: '#/components/responses/ApiError429' '500': $ref: '#/components/responses/ApiError500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - sending-strategy:manage x-throttling-info: - type: time numberOfRequests: 1 numberOfTimeUnits: 0 timeUnit: s post: tags: - platform summary: Create sending strategy description: Create sending strategy. operationId: create-sending-strategy-v2 requestBody: content: application/json: schema: $ref: '#/components/schemas/5929f45c31f06c29ab1bc6e26caa01575484225e5ef99a2512bee829b646f1c1.SssRequestV2' examples: Application level: summary: Application level description: Application level value: platform: applicationId: default Application/Entity level: summary: Application/Entity level description: Application/Entity level value: platform: entityId: test-entity-1 applicationId: test-application-1 channel: MMS destinationCountryCode: CA Application level with additional features: summary: Application level with additional features description: Application level with additional features value: platform: applicationId: default channel: SMS useStickySender: true Application/Entity level with additional features: summary: Application/Entity level with additional features description: Application/Entity level with additional features value: platform: entityId: test-entity-1 applicationId: test-application-1 channel: SMS destinationCountryCode: US useStickySender: true useGeolocatedSender: true priorities: - senderType: VIRTUAL_LONG_NUMBER priority: 1 - senderType: TOLL_FREE_NUMBER priority: 2 required: true responses: '201': description: Created. content: application/json: schema: $ref: '#/components/schemas/5929f45c31f06c29ab1bc6e26caa01575484225e5ef99a2512bee829b646f1c1.SendingStrategyId' examples: Response example: summary: Response example value: sendingStrategyId: 78D8394AC3EG0460B4CF0E723FC31B49 '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/ApiError' examples: Bad request: summary: Bad request value: errorCode: E400 description: Request cannot be processed. action: Check the syntax, violations and adjust the request. violations: - property: property.path violation: Violation message. resources: [] '401': $ref: '#/components/responses/ApiError401' '403': $ref: '#/components/responses/ApiError403' '429': $ref: '#/components/responses/ApiError429' '500': $ref: '#/components/responses/ApiError500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - sending-strategy:manage x-throttling-info: - type: time numberOfRequests: 1 numberOfTimeUnits: 0 timeUnit: s /provisioning/2/sending-strategies/{sendingStrategyId}: delete: tags: - platform summary: Delete sending strategy by sending strategy id description: Delete sending strategy by sending strategy id. operationId: delete-sending-strategy-by-sending-strategy-id-v2 parameters: - name: sendingStrategyId in: path description: Id of the Sending Strategy. required: true style: simple explode: false schema: type: string example: 78D8394AC3EG0460B4CF0E723FC31B49 responses: '204': description: No content. '400': description: Bad request. content: application/json: schema: $ref: '#/components/schemas/ApiError' examples: Bad request: summary: Bad request value: errorCode: E400 description: Request cannot be processed. action: Check the syntax, violations and adjust the request. violations: - property: property.path violation: Violation message. resources: [] '401': $ref: '#/components/responses/ApiError401' '403': $ref: '#/components/responses/ApiError403' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': $ref: '#/components/responses/ApiError429' '500': $ref: '#/components/responses/ApiError500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - sending-strategy:manage x-throttling-info: - type: time numberOfRequests: 1 numberOfTimeUnits: 0 timeUnit: s /platform/1/blocklists: get: tags: - platform summary: Get all blocklists description: This method allows you to get all blocklist records or filter them based on specific parameters. operationId: get-all-blocklists parameters: - name: sender in: query description: The sender ID for which blocklist happened. required: false style: form explode: true schema: type: string example: '10950' maxLength: 255 minLength: 1 - name: destination in: query description: Blocklisted destination address. required: false style: form explode: true schema: type: string example: '41793026727' maxLength: 255 minLength: 1 - name: channel in: query description: 'Channel used for sending for which blocklist happened. If you want to check blocklist records for all channels, this field can be left out.' required: false style: form explode: true schema: $ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.ViewableChannel' - name: sourceType in: query description: 'Represents the way blocklist record was created: CUSTOM - blocklist record that was created manually MO - blocklist record automatically created once an end user unsubscribes by replying with a specific keyword (e.g.: STOP). This is applicable for the following channels: SMS, MMS. URL_OPT_OUT - blocklist record automatically created once an end user clicks an opt-out link included in the message. CAMPAIGN - blocklist record automatically created through a triggered event in the Flow (e.g., if the message was not opened in 24h, add to blocklist).' required: false style: form explode: true schema: $ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.SourceType' - name: accountKey in: query description: Account connected with a blocklist record. Main account has access to blocklist records of their subaccounts. Subaccounts can only access blocklist records specific to them. [API to retrieve account key](https://www.infobip.com/docs/api/platform/account-management/get-all-accounts). required: false style: form explode: true schema: type: string example: 8F0792F86035A9F4290821F1EE6BC06A - name: getAllAccountKeysBlocklists in: query description: If set to `true`, blocklist records for subaccounts will be returned as well. required: false style: form explode: true schema: type: boolean example: false - name: createdDateFrom in: query description: Use with `createDateTo` to search for blocklists for a particular date range. required: false style: form explode: true schema: type: string format: date-time example: '2022-08-18T12:33:42.123Z' - name: createdDateTo in: query description: Use with `createDateFrom` to search for blocklists for a particular date range. required: false style: form explode: true schema: type: string format: date-time example: '2022-08-18T13:33:42.123Z' - name: campaign in: query description: ID that allows you to track, analyze, and show an aggregated overview and the performance of individual campaigns per sending channel. required: false style: form explode: true schema: type: string example: summersale maxLength: 255 minLength: 1 - name: page in: query description: Requested page number. required: false style: form explode: true schema: type: integer default: 0 example: 0 minimum: 0 - name: size in: query description: Requested page size. required: false style: form explode: true schema: type: integer default: 100 example: 10 maximum: 1000 minimum: 1 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.BlocklistGetResponse' examples: Response example: summary: Response example value: results: - sender: '10950' destination: '12022921990' sourceType: MO channel: MMS accountKey: 8F0792F86035A9F4290821F1EE6BC06A createdDate: '2022-08-18T12:36:42.123Z' - sender: '64350' destination: '12022921994' sourceType: CUSTOM channel: SMS accountKey: 8F0792F86035A9F4290821F1EE6BC06A createdDate: '2022-08-18T12:36:42.123Z' - sender: c5ab692f-b5d8-4bad-bee5-c121dc346a39 destination: urn:mbid:AQAAY3hr45FzBEsLpieCa0GANPlF399IiV/0gLSXRvwHauT0ph5Akk/Tx66ekESCF32bAOUHbSDCgQmZpGlyVr+wWepO0vPd7SUSQMUhjm+TTD7b/gGuVS6urpS2PL8I4GT+NW67K6VIO/1TeADk+Yu18i9HQfw= sourceType: MO channel: APPLE_MB accountKey: 8F0792F86035A9F4290821F1EE6BC06A createdDate: '2022-08-18T12:36:42.123Z' paging: page: 0 size: 10 totalPages: 1 totalResults: 2 '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/bad08f31d0530c669218bdbac07f91125fbbb50284a2712ce5d27fb95dd26628.ApiException' examples: Bad request example for filter request: summary: Bad request example for filter request description: Bad request example for filter request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: channel: - unsupported channel sender: - size must be between 1 and 255 sourceType: - unsupported source type destination: - size must be between 1 and 255 size: - must be less than or equal to 1000 page: - must be greater than or equal to 0 request: - created dates must be in supported format, both present and valid (`from` must be before `to`) Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '429': $ref: '#/components/responses/ApiException429' '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - blocklist:manage x-throttling-info: - type: time numberOfRequests: 1 numberOfTimeUnits: 0 timeUnit: s post: tags: - platform summary: Create blocklists description: This method allows you to add someone to blocklist. It accepts create request with blocklists and asynchronously saves them, leaving out duplicate entries. operationId: create-blocklists requestBody: content: application/json: schema: $ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.BlocklistCreateRequest' examples: Blocklist create request: summary: Blocklist create request description: Blocklist create request value: blocklist: - destinations: - to: '2025550954' - to: '2025550316' - sender: someone@example.com destinations: - to: jane.doe@example.com - to: john.doe@example.com channel: EMAIL accountKey: 8F0792F86035A9F4290821F1EE6BC06A required: true responses: '202': description: Accepted '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/bad08f31d0530c669218bdbac07f91125fbbb50284a2712ce5d27fb95dd26628.ApiException' examples: Bad request example for create request: summary: Bad request example for create request description: Bad request example for create request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: blocklist[1].accountKey: - unsupported account key blocklist[0].channel: - unsupported channel blocklist[0].destinations[0].to: - size must be between 1 and 255 blocklist[1].channel: - unsupported channel blocklist[1].destinations[1].to: - size must be between 1 and 255 blocklist[2].destinations: - must not be empty Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '429': $ref: '#/components/responses/ApiException429' '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - blocklist:manage x-throttling-info: - type: time numberOfRequests: 1 numberOfTimeUnits: 0 timeUnit: s delete: tags: - platform summary: Delete blocklists description: "This method allows you to remove someone from blocklist. It accepts delete request and asynchronously deletes all blocklists that match given properties. \n\nNote: To delete a blocklist, you must list all properties that were defined in the create request. For example, to delete the blocklist with the following properties: \n\n`{\"sender\": \"10950\", \"destination\": \"12022921990\", \"sourceType\": \"CUSTOM\", \"channel\": \"MMS\", \"createdDate\": \"2022-08-18T12:36:42.123Z\"}` \n\nThe delete request must contain all present properties, like this: \n\n`{\"blocklist\": [{\"destinations\": [{\"to\": \"12022921990\"}], \"sender\": \"10950\", \"channel\": \"MMS\", \"sourceType\": \"CUSTOM\"}`. \n\nOnly when all properties are listed will the blocklist be removed." operationId: delete-blocklists requestBody: content: application/json: schema: $ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.BlocklistDeleteRequest' examples: Blocklist delete request: summary: Blocklist delete request description: Blocklist delete request value: blocklist: - destinations: - to: '2025550954' - to: '2025550316' sourceType: CAMPAIGN - sender: someone@example.com destinations: - to: jane.doe@example.com - to: john.doe@example.com channel: EMAIL accountKey: 8F0792F86035A9F4290821F1EE6BC06A sourceType: CUSTOM required: true responses: '202': description: Accepted '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/bad08f31d0530c669218bdbac07f91125fbbb50284a2712ce5d27fb95dd26628.ApiException' examples: Bad request example for delete request: summary: Bad request example for delete request description: Bad request example for delete request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request validationErrors: blocklist[1].accountKey: - unsupported account key blocklist[0].channel: - unsupported channel blocklist[0].sourceType: - unsupported source type blocklist[0].destinations[0].to: - size must be between 1 and 255 blocklist[1].channel: - unsupported channel blocklist[1].destinations[1].to: - size must be between 1 and 255 blocklist[2].destinations: - must not be empty Bad request: summary: Bad request value: requestError: serviceException: messageId: BAD_REQUEST text: Bad request '401': $ref: '#/components/responses/ApiException401' '403': $ref: '#/components/responses/ApiException403' '429': $ref: '#/components/responses/ApiException429' '500': $ref: '#/components/responses/ApiException500' security: - IBSSOTokenHeader: [] - APIKeyHeader: [] - Basic: [] - OAuth2: [] x-scopes: - blocklist:manage x-throttling-info: - type: time numberOfRequests: 1 numberOfTimeUnits: 0 timeUnit: s /catalogs/1/catalogs: get: tags: - platform summary: Get catalogs description: Use this method to get a list of catalogs with pagination. Query parameters are optional and can be used to narrow down the results. operationId: get-catalogs parameters: - name: ids in: query description: Catalog IDs. required: false style: form explode: true schema: type: array items: type: integer format: int64 example: 1,2,3,4,5 - name: name in: query description: Catalog name. required: false style: form explode: true schema: type: string example: Catalog name - name: type in: query description: Catalog type. required: false style: form explode: true schema: type: string example: blank - name: page in: query description: Results page to retrieve (0..N). required: false style: form explode: true schema: type: integer format: int32 default: 0 minimum: 0 - name: size in: query description: Number of catalogs per page. required: false style: form explode: true schema: type: integer format: int32 default: 10 maximum: 100 minimum: 1 responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.PageResponseDto' examples: Response example: summary: Response example value: results: - id: 10061 name: Catalog-534 description: desc type: BLANK - id: 10062 name: Catalog-535 description: desc type: BLANK paging: page: 1 size: 20 totalPages: 1 totalResults: 2 application/xml: examples: Response example: summary: Response example value: "
100 catalog fields are allowed.| Logical Operator | Description |
|---|---|
AND | Joins query clauses with a logical AND. Returns all items that match the conditions of both clauses. Example: price > 10.99 AND color == Red |
OR | Joins query clauses with a logical OR. Returns all items that match the conditions of either clause. Example: type == Jeans OR type == Shirt |
| Comparison Operator | Supported Type | Description |
|---|---|---|
Greater than: > | integer, decimal | Matches values that are greater than a specified value. Example: price > 99.99 |
Greater or equal: ≥ | integer, decimal | Matches all values that are greater than or equal to a specified value. Example: price ≥ 99.99 |
Less than: < | integer, decimal | Matches all values that are less than a specified value. Example: price < 99.99 |
Less or equal: ≤ | integer, decimal | Matches all that are values less than or equal to a specified value. Example: price ≤ 99 |
Equal: == | integer, decimal, string, date, time, dateTime | Matches values that are equal to a specified value. Example: color == |
Not equal: != | integer, decimal, string, date, time, dateTime | Matches values that are not equal to a specified value. Example: color != |
| Date/time Range Operator | Supported Type | Description |
|---|---|---|
BETWEEN | date, time, dateTime | Specifies date/time range between dates. Example: createdAt BETWEEN |
NOT BETWEEN | date, time, dateTime | Specifies date/time range not between dates. Example: createdAt NOT BETWEEN |
| String Operator | Supported Type | Description |
|---|---|---|
STARTS WITH | string | Matches all values starting with specific substring. Example: name STARTS WITH |
ENDS WITH | string | Matches all values ending with specific substring. Example: name ENDS WITH |
1000 item field values are allowed.| Logical Operator | Description |
|---|---|
AND | Joins query clauses with a logical AND. Returns all items that match the conditions of both clauses. Example: price > 10.99 AND color == Red |
OR | Joins query clauses with a logical OR. Returns all items that match the conditions of either clause. Example: type == Jeans OR type == Shirt |
| Comparison Operator | Supported Type | Description |
|---|---|---|
Greater than: > | integer, decimal | Matches values that are greater than a specified value. Example: price > 99.99 |
Greater or equal: ≥ | integer, decimal | Matches all values that are greater than or equal to a specified value. Example: price ≥ 99.99 |
Less than: < | integer, decimal | Matches all values that are less than a specified value. Example: price < 99.99 |
Less or equal: ≤ | integer, decimal | Matches all that are values less than or equal to a specified value. Example: price ≤ 99 |
Equal: == | integer, decimal, string, date, time, dateTime | Matches values that are equal to a specified value. Example: color == |
Not equal: != | integer, decimal, string, date, time, dateTime | Matches values that are not equal to a specified value. Example: color != |
| Date/time Range Operator | Supported Type | Description |
|---|---|---|
BETWEEN | date, time, dateTime | Specifies date/time range between dates. Example: createdAt BETWEEN |
NOT BETWEEN | date, time, dateTime | Specifies date/time range not between dates. Example: createdAt NOT BETWEEN |
| String Operator | Supported Type | Description |
|---|---|---|
STARTS WITH | string | Matches all values starting with specific substring. Example: name STARTS WITH |
ENDS WITH | string | Matches all values ending with specific substring. Example: name ENDS WITH |
| Logical Operator | Description |
|---|---|
AND | Joins query clauses with a logical AND. Returns all items that match the conditions of both clauses. Example: price > 10.99 AND color == Red |
OR | Joins query clauses with a logical OR. Returns all items that match the conditions of either clause. Example: type == Jeans OR type == Shirt |
| Comparison Operator | Supported Type | Description |
|---|---|---|
Greater than: > | integer, decimal | Matches values that are greater than a specified value. Example: price > 99.99 |
Greater or equal: ≥ | integer, decimal | Matches all values that are greater than or equal to a specified value. Example: price ≥ 99.99 |
Less than: < | integer, decimal | Matches all values that are less than a specified value. Example: price < 99.99 |
Less or equal: ≤ | integer, decimal | Matches all that are values less than or equal to a specified value. Example: price ≤ 99 |
Equal: == | integer, decimal, string, date, time, dateTime | Matches values that are equal to a specified value. Example: color == |
Not equal: != | integer, decimal, string, date, time, dateTime | Matches values that are not equal to a specified value. Example: color != |
| Date/time Range Operator | Supported Type | Description |
|---|---|---|
BETWEEN | date, time, dateTime | Specifies date/time range between dates. Example: createdAt BETWEEN |
NOT BETWEEN | date, time, dateTime | Specifies date/time range not between dates. Example: createdAt NOT BETWEEN |
| String Operator | Supported Type | Description |
|---|---|---|
STARTS WITH | string | Matches all values starting with specific substring. Example: name STARTS WITH |
ENDS WITH | string | Matches all values ending with specific substring. Example: name ENDS WITH |
number, numberKey, resource or resourceKey.configurationKey none of previously mentioned parameters are needed.'
externalDocs:
description: Read more about keywords
url: https://www.infobip.com/docs/numbers/keywords-and-actions
operationId: get-inbound-configurations
parameters:
- name: configurationKey
in: query
description: Unique ID of configuration.
required: false
style: form
explode: true
schema:
type: string
description: Unique ID of configuration.
example: 58BC6DB7966CB9F69A91EB956DF73239
example: 58BC6DB7966CB9F69A91EB956DF73239
- name: number
in: query
required: false
style: form
explode: true
schema:
type: string
example: '41793026727'
example: 41793026727
- name: numberKey
in: query
description: Unique ID of a number.
required: false
style: form
explode: true
schema:
type: string
description: Unique ID of a number.
example: 58BC6DB7966CB9F69A91EB956DF73239
example: 58BC6DB7966CB9F69A91EB956DF73239
- name: resource
in: query
required: false
style: form
explode: true
schema:
type: string
example: '41793026727'
example: 41793026727
- name: resourceKey
in: query
description: Unique ID of a resource.
required: false
style: form
explode: true
schema:
type: string
description: Unique ID of a resource.
example: 58BC6DB7966CB9F69A91EB956DF73239
example: 58BC6DB7966CB9F69A91EB956DF73239
- name: keyword
in: query
description: Configuration keyword.
required: false
style: form
explode: true
schema:
type: string
description: Configuration keyword.
example: STARTKW
maxLength: 50
minLength: 0
example: STARTKW
- name: channel
in: query
description: Required if number, numberKey, resource or resourceKey present.
required: true
style: form
explode: true
schema:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.ConfigurationType'
example: SMS
- name: countryCode
in: query
description: Country code in two-letter ISO standard. Required for identifying country specific resources (for instance, short code number types).
required: false
style: form
explode: true
schema:
type: string
description: Country code in two-letter ISO standard. Required for identifying country specific resources (for instance, short code number types).
example: GB
pattern: ^[A-Z]{2}$
example: GB
responses:
'200':
description: OK
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MoConfigurationResponse'
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'404':
description: Not Found
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- numbers:manage
x-throttling-info:
- type: time
numberOfRequests: 2
numberOfTimeUnits: 0
timeUnit: s
post:
tags:
- platform
summary: Manage inbound configuration
description: Create and update configuration details for incoming messages. Each action type and channel will require different parameters.
externalDocs:
description: Read more about keywords
url: https://www.infobip.com/docs/numbers/keywords-and-actions
operationId: manage-inbound-configuration
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MoConfigurationRequest'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MoConfigurationResponse'
'400':
$ref: '#/components/responses/ApiException400'
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'404':
description: Not Found
'429':
$ref: '#/components/responses/ApiException429'
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- numbers:manage
x-throttling-info:
- type: token
replenishRate: 2
requestedTokens: 1
burstCapacity: 10
/resource-management/1/inbound-message-configurations/{configurationKey}:
delete:
tags:
- platform
summary: Delete inbound configuration
description: This method will delete the configuration.
externalDocs:
description: Read more about keywords
url: https://www.infobip.com/docs/numbers/keywords-and-actions
operationId: delete-inbound-configuration
parameters:
- name: configurationKey
in: path
description: Unique ID of configuration.
required: true
style: simple
explode: false
schema:
type: string
description: Unique ID of configuration.
example: 58BC6DB7966CB9F69A91EB956DF73239
example: 58BC6DB7966CB9F69A91EB956DF73239
responses:
'204':
description: No Content
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'404':
description: Not Found
'429':
$ref: '#/components/responses/ApiException429'
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- numbers:manage
x-throttling-info:
- type: time
numberOfRequests: 1
numberOfTimeUnits: 0
timeUnit: s
/resources/1/resources:
post:
tags:
- platform
summary: Search resources
description: 'Search resources already owned by your account, such as senders and usable numbers, using filters. This endpoint does not return available resources for purchase or request, it only lists resources that are currently assigned to you.platform.
enum:
- PUBLIC_API
- 2FA_CLIENT
- WEB_SDK
items:
type: string
description: List of permissions this API key has granted. Default permission is 'PUBLIC_API'. API key cannot be created with both 'PUBLIC_API' and 'WEB_SDK' permissions. API key cannot be created with both permissions and a collection of Applications and/or Entities in platform.
enum:
- PUBLIC_API
- 2FA_CLIENT
- WEB_SDK
platform:
type: array
description: A collection of CPaaS X Applications and Entities that will be linked to the API Key. API key cannot be created with both permissions and a collection of Applications and/or Entities.
externalDocs:
description: API Key will only have access to these endpoints.
url: https://www.infobip.com/docs/cpaas-x/application-and-entity-management#api-keys-endpoints-list-api-keys-with-application-and-entity
items:
$ref: '#/components/schemas/bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.Platform'
scopeGuids:
type: array
description: List of [API scopes](https://www.infobip.com/docs/essentials/api-essentials/api-authorization#available-api-scopes-api-scopes) that will be assigned to the API key.
items:
type: string
description: List of [API scopes](https://www.infobip.com/docs/essentials/api-essentials/api-authorization#available-api-scopes-api-scopes) that will be assigned to the API key.
uniqueItems: true
required:
- name
title: CreateApiKeyRequest
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.WebhookReminderNotifApiDocRequestBody:
type: object
properties:
results:
type: array
description: List of events provided in a single request.
items:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.WebhookReminderNotifApiDocResult'
title: WebhookReminderNotifApiDocRequestBody
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignAiBuilderWebhookMessage:
type: object
description: Incoming events
properties:
event:
type: string
description: The name of the event.
enum:
- AI_CAMPAIGN_BUILDER
example: AI_CAMPAIGN_BUILDER
receivedAt:
type: string
format: date-time
description: Date and time when Infobip received the event.
content:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignAiBuilderWebhookContent'
platform:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignWebhookPlatform'
title: CampaignAiBuilderWebhookMessage
aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6e.EmailStatus:
type: object
properties:
description:
type: string
description: Human-readable description of the status.
readOnly: false
writeOnly: false
name:
type: string
description: '[Status name](https://www.infobip.com/docs/essentials/response-status-and-error-codes).'
readOnly: false
writeOnly: false
title: EmailStatus
bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.CreateApiKeyRequestV1:
type: object
properties:
name:
type: string
description: Name of the API key
allowedIPs:
type: array
description: List of IP addresses or IP ranges from which this API key will be used. Authentication will fail from any other IP not specified in this list.
items:
type: string
description: List of IP addresses or IP ranges from which this API key will be used. Authentication will fail from any other IP not specified in this list.
validTo:
type: string
format: date-time
description: Date from which this API key is/will be valid. Time is in UTC
validFrom:
type: string
format: date-time
description: Date until this API key will be valid. Time is in UTC.
enabled:
type: boolean
description: Only enabled API keys will be accepted. When revoking existing API key, this property can be set to false.
permissions:
type: array
description: List of permissions this API key has granted. Default permission is 'ALL'. This data may be inaccurate. Migrate to new API key management endpoints and use API scopes for fine grained control.
items:
$ref: '#/components/schemas/bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.Permission'
required:
- name
title: CreateApiKeyRequestV1
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CertificateStatusResponse:
type: object
properties:
certificateId:
type: string
description: Certificate identifier.
status:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CertificateStatus'
title: CertificateStatusResponse
bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.Permission:
type: string
description: List of permissions this API key has granted. This data may be inaccurate. Migrate to new API key management endpoints and use API scopes for fine grained control.
enum:
- ALL
- TFA
- PUSH_CLIENT
- PEOPLE_EVENTS_PUBLIC_CLIENT
- EXTERNAL_INTEGRATIONS
title: Permission
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessageResponseDetails:
type: object
description: Other details of the message.
title: MessageResponseDetails
e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.CatalogItemDto:
type: object
properties:
id:
type: integer
format: int64
description: Item ID.
example: 10000
values:
type: array
description: A list of item field values. Maximum 1000 values.
items:
$ref: '#/components/schemas/e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.CatalogValueDto'
required:
- id
- values
title: CatalogItemDto
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleLineEvents:
type: string
enum:
- DELIVERY
- INBOUND_MESSAGE
title: Event
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.FacebookSubscriptionRequest:
type: object
description: Subscription group.
properties:
subscriptionId:
type: string
description: Subscription ID. Used as part of a URL path and must not include any characters that require URL encoding. You cannot change the ID once a subscription is created.
maxLength: 255
minLength: 1
name:
type: string
description: A human-readable description for your subscription, can be changed at a later point.
maxLength: 255
minLength: 1
events:
type: array
description: List of events available for a subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](https://www.infobip.com/docs/cpaas-x/subscriptions-management/event-subscriptions). If configuring inbound Subscription, check [inbound message configuration docs](https://www.infobip.com/docs/cpaas-x/subscriptions-management/inbound-message-configuration).
items:
oneOf:
- $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleFacebookEvents'
- $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.FormatAwareFacebookEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfileRequest'
required:
- events
- profile
- subscriptionId
title: Facebook
c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.Language:
type: string
enum:
- en
- es
- ca
- da
- nl
- fr
- de
- it
- ja
- ko
- 'no'
- pl
- ru
- sv
- fi
- hr
- sl
- ro
- pt_pt
- pt_br
- zh_cn
- zh_tw
title: Language
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.NoIdSecurityRequest:
type: object
description: Security configuration.
properties:
type:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CredentialsType'
credentials:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CredentialsPayload'
title: Security
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.PurchaseNumberRequest:
type: object
properties:
numberKey:
type: string
number:
type: string
applicationId:
type: string
description: ID of the Application that would be associated with the number.
externalDocs:
description: Find out more about Application and Application Management
url: https://www.infobip.com/docs/api/platform/application-entity
maxLength: 255
minLength: 0
entityId:
type: string
description: ID of the Entity that would be associated with the number.
externalDocs:
description: Find out more about Entity and Entity Management
url: https://www.infobip.com/docs/api/platform/application-entity
maxLength: 255
minLength: 0
title: PurchaseNumberRequest
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleViberEvents:
type: string
enum:
- CLICK
- CONSENT_UPDATE
- DELIVERY
- INBOUND_MESSAGE
- SEEN
- TEMPLATE_UPDATE
title: Event
c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.UpdateSmsOrVoiceMessageRequest:
type: object
properties:
language:
allOf:
- $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.Language'
description: Language code which message is written in. This is used when sending text-to-speech messages. If not defined, it will default to English (`en`).
readOnly: false
writeOnly: true
messageText:
type: string
description: Content of the message being sent which contains at minimum one placeholder for a PIN code (`{{pin}}`). Placeholder format is `{{placeholderName}}`.
readOnly: false
writeOnly: true
pinLength:
type: integer
format: int32
description: PIN code length.
readOnly: false
writeOnly: true
pinType:
allOf:
- $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.PinType'
description: The type of PIN code that will be generated and sent as part of a 2FA message.
readOnly: false
writeOnly: true
regional:
allOf:
- $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.RegionalOptions'
description: Region-specific parameters, often imposed by local laws. Use this, if country or region that you are sending a message to requires additional information.
readOnly: false
writeOnly: true
repeatDTMF:
type: string
description: If the PIN is sent as a voice message, the DTMF code allows the recipient to replay the message.
readOnly: false
writeOnly: true
senderId:
type: string
description: The name that will appear as the sender of the 2FA message (e.g. CompanyName).
readOnly: false
writeOnly: true
speechRate:
type: number
format: double
description: The speed of narration for messages sent as voice. Supported range is from `0.5` to `2`.
readOnly: false
writeOnly: true
voiceName:
type: string
description: 'Defines the voice that will be used for the chosen language (example: Joanna). For each supported language, we may offer different voices (learn more [here](https://www.infobip.com/docs/voice-and-video/reference#text-to-speech-languages)). You can use this [method](https://www.infobip.com/docs/api/channels/voice/voice-message/get-voices) to retrieve all voices for the given language. If not defined, it will default to the standard voice for the selected language (if available). If the standard voice is not available, the request will fail. To avoid that, you can choose one of the neural voices (charges will apply).'
readOnly: false
writeOnly: true
title: UpdateSmsOrVoiceMessageRequest
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.OpenChannelSubscriptionRequest:
type: object
description: Subscription group.
properties:
subscriptionId:
type: string
description: Subscription ID. Used as part of a URL path and must not include any characters that require URL encoding. You cannot change the ID once a subscription is created.
maxLength: 255
minLength: 1
name:
type: string
description: A human-readable description for your subscription, can be changed at a later point.
maxLength: 255
minLength: 1
events:
type: array
description: List of events available for a subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](https://www.infobip.com/docs/cpaas-x/subscriptions-management/event-subscriptions). If configuring inbound Subscription, check [inbound message configuration docs](https://www.infobip.com/docs/cpaas-x/subscriptions-management/inbound-message-configuration).
items:
oneOf:
- $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleOpenChannelEvents'
- $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.FormatAwareOpenChannelEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfileRequest'
required:
- events
- profile
- subscriptionId
title: Open Channel
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleEmailEvents:
type: string
enum:
- CLICK
- COMPLAINT
- DELIVERY
- HIGH_BOUNCE_RATE_BLOCKED
- HIGH_BOUNCE_RATE_WARNING
- LATE_BOUNCE
- OPEN
- UNSUBSCRIBE
title: Event
aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6e.ResendPinRequestViaEmail:
type: object
properties:
landingPagePlaceholders:
type: object
additionalProperties:
type: string
description: 'Key value pairs that will be replaced when using personalized opt out landing page. Placeholder keys should NOT contain curly brackets and should NOT contain a `pin` placeholder. Valid example: `"landingPagePlaceholders":{"name":"John", "surname": "Smith"}`'
readOnly: false
writeOnly: true
placeholders:
type: object
additionalProperties:
type: string
description: 'Key value pairs that will be replaced during message sending. Placeholder keys should NOT contain curly brackets and should NOT contain a `pin` placeholder. Valid example: `"placeholders":{"firstName":"John"}`'
readOnly: false
writeOnly: true
title: ResendPinRequestViaEmail
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiBaseFailover:
type: object
description: Provides options for configuring a message failover. When message fails it will be sent over channels in order specified in an array. It has to contain unique entries per channel and it cannot contain entry with the same channel as original message. **Make sure to provide correct sender and destinations specified as `Channels Destination` for each channel**.
oneOf:
- $ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiFailover'
- $ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateFailover'
title: MessagesApiBaseFailover
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.TransliterationCode:
type: string
description: 'The transliteration of your sent message from one script to another. Transliteration is used to replace characters which are not recognized as part of your defaulted alphabet. Possible values: `TURKISH`, `GREEK`, `CYRILLIC`, `SERBIAN_CYRILLIC`, `BULGARIAN_CYRILLIC`, `CENTRAL_EUROPEAN`, `BALTIC`, `PORTUGUESE`, `COLOMBIAN`, and `NON_UNICODE`. Supported by SMS.'
enum:
- NONE
- TURKISH
- GREEK
- CYRILLIC
- SERBIAN_CYRILLIC
- CENTRAL_EUROPEAN
- BALTIC
- NON_UNICODE
- PORTUGUESE
- COLOMBIAN
- BULGARIAN_CYRILLIC
- ALL
title: TransliterationCode
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.PriorityType:
type: string
description: Type of a priority
enum:
- TEN_DLC
- SHORT_CODE
- TFN
title: PriorityType
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.AlphaWebhookStatusNotifApiDoc:
type: object
properties:
id:
type: string
description: ID of the resource request.
status:
type: string
description: Status of the resource request.
enum:
- UPDATE_REQUESTED
- UPDATE_REQUESTED_BY_INTERNAL_REVIEWER
- REJECTED
- COMPLETED
type:
type: string
description: Type of resource.
enum:
- ALPHANUMERIC_REGISTRATION
requirementsFeedback:
type: array
description: Feedback for requirements. Present only for UPDATE_REQUESTED and UPDATE_REQUESTED_BY_INTERNAL_REVIEWER statuses.
items:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.FilledRequirementFeedbackApiDoc'
note:
type: string
description: A note containing extra data about the request.
required:
- id
- status
title: ALPHANUMERIC_REGISTRATION
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.VoiceVideoNoIdSubscriptionRequest:
type: object
description: Subscription group.
properties:
name:
type: string
description: Subscription group name.
maxLength: 255
minLength: 1
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyProfileRequest'
events:
type: array
description: List of events available for subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](/docs/cpaas-x/subscriptions-management#availability). In case you are configuring inbound Subscription please check all the details [available here](/docs/cpaas-x/subscriptions-management#inbound-message-configuration).
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleVoiceVideoEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
required:
- events
- profile
title: Voice and Video
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiDeliveryReportResponse:
type: object
properties:
results:
type: array
description: Incoming Delivery reports.
items:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiDeliveryResult'
required:
- results
title: MessagesApiDeliveryReportResponse
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.LineNoIdSubscriptionRequest:
type: object
description: Subscription group.
properties:
name:
type: string
description: Subscription group name.
maxLength: 255
minLength: 1
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyProfileRequest'
events:
type: array
description: List of events available for subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](/docs/cpaas-x/subscriptions-management#availability). In case you are configuring inbound Subscription please check all the details [available here](/docs/cpaas-x/subscriptions-management#inbound-message-configuration).
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleLineEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
required:
- events
- profile
title: Line
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CustomerEngagementNoIdSubscriptionRequest:
type: object
description: Subscription group.
properties:
name:
type: string
description: Subscription group name.
maxLength: 255
minLength: 1
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyProfileRequest'
events:
type: array
description: List of events available for subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](/docs/cpaas-x/subscriptions-management#availability). In case you are configuring inbound Subscription please check all the details [available here](/docs/cpaas-x/subscriptions-management#inbound-message-configuration).
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleCustomerEngagementEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
required:
- events
- profile
title: Customer Engagement
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessageOrderingOptions:
type: object
description: Message ordering options.
properties:
respectOrder:
type: boolean
default: true
description: If set to `true`, messages will be sent in the same order as they are provided in the request.
stopOnFailure:
type: boolean
default: true
description: It can be used in combination with `respectOrder` to stop sending messages when first message from request fails.
title: MessageOrderingOptions
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.ShortCodeCampaignBuilderResultMessageFlow:
type: object
description: Campaign message flow for Short Code campaigns
properties:
optInMessage:
type: string
description: Opt-in confirmation message
exampleMessage1:
type: string
description: First example message
exampleMessage2:
type: string
description: Second example message
helpMessage:
type: string
description: Help response message
optOutMessage:
type: string
description: Opt-out response message
title: ShortCodeCampaignBuilderResultMessageFlow
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CertificatesSortType:
type: string
enum:
- CERTIFICATE_ID
title: CertificatesSortType
e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.CatalogTypes:
type: string
description: Catalog type.
enum:
- BLANK
- PRODUCTS
- STORES
- ARTICLES
example: BLANK
title: CatalogTypes
8107508a6b6ebe39d7ea5cd4a2338a61e45bf1b939b4ec9bc51846ab35de14ea.ApiException:
type: object
properties:
requestError:
$ref: '#/components/schemas/ApiRequestError'
required:
- requestError
title: ApiException
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.WebOptIn:
type: object
description: The type of opt in that requires a user to follow a URL.
properties:
callToAction:
type: string
description: " The message sent to the user to tell them how to subscribe. Must include:\n • Product description\n • Message frequency disclosure\n • Complete terms and conditions OR link to complete terms and conditions\n • Privacy policy OR link to privacy policy\n • STOP keyword\n • The \"Message and data rates may apply\" disclosure\n"
maxLength: 1024
minLength: 20
url:
type: string
maxLength: 255
minLength: 11
required:
- callToAction
title: WebOptIn
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.FilledRequirement:
type: object
description: List of requirements for the resource.
properties:
key:
type: string
description: The key of the requirement.
value:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.JsonNode'
required:
- key
- value
title: FilledRequirement
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfilePage:
type: object
properties:
results:
type: array
description: The list of the results for this page.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfileResponse'
paging:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.PageInfo'
title: ProfilePage
aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6e.VerifyPinResponse:
type: object
properties:
attemptsRemaining:
type: integer
format: int32
description: Number of remaining PIN attempts.
readOnly: true
writeOnly: false
msisdn:
type: string
description: Phone number (`MSISDN`) to which the 2FA message was sent.
readOnly: true
writeOnly: false
pinError:
type: string
description: Indicates whether an error has occurred during PIN verification.
readOnly: true
writeOnly: false
pinId:
type: string
description: Sent PIN code ID.
readOnly: true
writeOnly: false
verified:
type: boolean
description: Indicates whether the phone number (`MSISDN`) was successfully verified.
readOnly: true
writeOnly: false
title: VerifyPinResponse
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiDeliveryResult:
type: object
description: Incoming Delivery reports.
properties:
event:
type: string
default: DELIVERY
description: Event type (delivery report in this case).
channel:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.InboundDlrChannel'
sender:
type: string
description: The sender ID which can be alphanumeric or numeric (e.g., `CompanyName`).
destination:
type: string
description: Message destination address.
sentAt:
type: string
description: 'Tells when the message was sent. Has the following format: `yyyy-MM-dd''T''HH:mm:ss.SSSZ`.'
doneAt:
type: string
description: 'Tells when the message was finished processing by Infobip (ie. delivered to destination, delivered to destination network, etc.). Has the following format: `yyyy-MM-dd''T''HH:mm:ss.SSSZ`.'
bulkId:
type: string
description: The ID that uniquely identifies the request.
messageId:
type: string
description: The ID that uniquely identifies the received message.
callbackData:
type: string
description: Value of the `callbackData` field from the MT message (if exists) or from the MO Action setup (if exists).
messageCount:
type: integer
format: int32
description: The number of parts the message content was split into.
status:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiDeliveryStatus'
error:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiDeliveryError'
platform:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.Platform'
deviceDetails:
type: string
description: Device name if available.
mccMnc:
type: integer
format: int32
description: Mobile country and network codes.
networkId:
type: integer
format: int32
description: Network id dependent on Country.
campaignReferenceId:
type: string
description: ID of a campaign that was sent in the message.
required:
- bulkId
- channel
- destination
- doneAt
- error
- event
- messageCount
- messageId
- sender
- sentAt
- status
title: MessagesApiDeliveryResult
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.UpdateResourceOrderRequest:
type: object
properties:
requirements:
type: array
description: List of requirements for the resource.
items:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.FilledRequirement'
required:
- requirements
title: UpdateResourceOrderRequest
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.VoiceSetup:
type: object
description: Voice setup configuration.
properties:
applicationId:
type: string
description: ID of the Application that would be associated with the voice setup.
externalDocs:
description: Find out more about Application and Application Management
url: https://www.infobip.com/docs/api/platform/application-entity
maxLength: 255
minLength: 0
entityId:
type: string
description: ID of the Entity that would be associated with the voice setup.
externalDocs:
description: Find out more about Entity and Entity Management
url: https://www.infobip.com/docs/api/platform/application-entity
maxLength: 255
minLength: 0
action:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.VoiceActionDetails'
required:
- action
title: VoiceSetup
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MoActionType:
type: string
description: Defines action type. It is not possible to create new action type.
enum:
- PULL
- HTTP_FORWARD
- SMPP_FORWARD
- MAIL_FORWARD
- NO_ACTION
- BLOCK
- AUTORESPONSE
- USSD
- SEND_BULK_MT
- EMAIL_TO_SMS_FORWARD
- CNS_FWD
- USE_CONVERSATIONS
- FORWARD_TO_PSTN
- FORWARD_TO_IP
- FORWARD_TO_IVR
- VOICE_NUMBER_MASKING
- VOICE_CALL_DROP
- FORWARD_TO_WEBRTC
- VOICE_FORWARD_TO_CONVERSATIONS
- VOICE_FORWARD_TO_CONVERSATIONS_WITH_FLOW
- CALL_FORWARD_TO_APPLICATION
- FORWARD_TO_SUBSCRIPTION
- FORWARD_TO_CALL_ROUTING
- USE_ANSWERS
- VOICE_FORWARD_TO_ANSWERS
- VOICE_FORWARD_TO_FLOW
- VOICE_FORWARD_TO_FLOW_WITH_CONVERSATIONS
- FORWARD_TO_OPERATOR_CONNECT
- FORWARD_TO_EXTERNAL_INTEGRATION
- FORWARD_TO_AI_AGENT
- FORWARD_TO_MARKUP_LANGUAGE
- OTHER
title: MoActionType
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleBlocklistEvents:
type: string
enum:
- BLOCK
- UNBLOCK
title: Event
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.WebhookCampaignStage:
type: string
description: The new campaign registration.
enum:
- REGISTERED
- REJECTED
- DEREGISTERED
- SUBMITTED
- APPROVED_BY_INTERNAL_REVIEWER
example: REJECTED
title: WebhookCampaignStage
e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.Paging:
type: object
description: Pagination information.
properties:
page:
type: integer
format: int32
description: Current page.
example: 1
size:
type: integer
format: int32
description: Page size.
example: 20
totalPages:
type: integer
format: int32
description: Total amount of pages.
example: 5
totalResults:
type: integer
format: int64
description: Total amount of results.
example: 100
required:
- page
- size
- totalPages
- totalResults
title: Paging
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.NumberCapabilityType:
type: string
description: An array of communication channels the number can support.
enum:
- SMS
- VOICE
- MMS
- WHATSAPP
- WHATSAPP_VOICE
title: NumberCapabilityType
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.FormatAwareFacebookEvents:
type: object
properties:
event:
type: string
enum:
- CLICK
- CONSENT_UPDATE
- DELIVERY
- INBOUND_MESSAGE
- SEEN
format:
type: string
description: Format which you want to assign to the event. For more information about available formats and their payload, check our [Event Formats](https://www.infobip.com/docs/cpaas-x/subscriptions-management/event-formats) page.
required:
- event
- format
title: Event with format
aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6e.VerifyPinRequest:
type: object
properties:
pin:
type: string
description: The PIN code to verify.
readOnly: false
writeOnly: true
required:
- pin
title: VerifyPinRequest
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.UpdateOwnedNumberRequest:
type: object
properties:
applicationId:
type: string
description: ID of the Application that would be associated with the number.
externalDocs:
description: Find out more about Application and Application Management
url: https://www.infobip.com/docs/api/platform/application-entity
minLength: 1
entityId:
type: string
description: ID of the Entity that would be associated with the number.
externalDocs:
description: Find out more about Entity and Entity Management
url: https://www.infobip.com/docs/api/platform/application-entity
required:
- applicationId
title: UpdateOwnedNumberRequest
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.BlocklistSubscriptionRequest:
type: object
description: Subscription group.
properties:
subscriptionId:
type: string
description: Subscription ID. Used as part of a URL path and must not include any characters that require URL encoding. You cannot change the ID once a subscription is created.
maxLength: 255
minLength: 1
name:
type: string
description: A human-readable description for your subscription, can be changed at a later point.
maxLength: 255
minLength: 1
events:
type: array
description: List of events available for a subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](https://www.infobip.com/docs/cpaas-x/subscriptions-management/event-subscriptions). If configuring inbound Subscription, check [inbound message configuration docs](https://www.infobip.com/docs/cpaas-x/subscriptions-management/inbound-message-configuration).
items:
oneOf:
- $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleBlocklistEvents'
- $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.FormatAwareBlocklistEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfileRequest'
required:
- events
- profile
- subscriptionId
title: Blocklist
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleAppleMessagesForBusinessEvents:
type: string
enum:
- DELIVERY
- INBOUND_MESSAGE
title: Event
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.NumberCoverageInfo:
type: object
description: Information about the number coverage.
properties:
number:
type: string
description: Phone number.
example: '447860041117'
numberKey:
type: string
description: Number key.
example: 58B3840032C7774BAC840EEEA2C23A44
platform:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.PlatformDocs'
numberType:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.NumberType'
countryCode:
type: string
description: Country code in two-letter ISO standard. Required for identifying country specific resources (for instance, short code number types).
example: GB
pattern: ^[A-Z]{2}$
countryName:
type: string
description: Country name.
example: United Kingdom
capabilities:
type: array
items:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.IbResourceCapability'
uniqueItems: true
resourceType:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.IbResourceType'
title: Number
99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.TimeSpan:
type: object
description: "\nRepresents the time within which a message is opened after the message is delivered using time buckets.\n\nFor example, you can filter only for messages opened within 1 second after they were delivered. The `from` bucket is inclusive, while the `to` bucket is exclusive.\n "
properties:
from:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.TimeBucket'
to:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.TimeBucket'
title: TimeSpan
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SecurityResponse:
type: object
description: Security configuration.
properties:
authId:
type: string
description: Unique authorization ID.
type:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CredentialsType'
credentials:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CredentialsPayload'
title: Security
aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6e.StartEmailAuthenticationRequest:
type: object
properties:
applicationId:
type: string
description: The ID of the application that represents your service, e.g. 2FA for login, 2FA for changing the password, etc.
readOnly: false
writeOnly: false
from:
type: string
description: Use this parameter if you wish to override the sender from the [created](#channels/sms/create-2fa-email-message-template) Email message template parameter `from`.
readOnly: false
writeOnly: false
landingPagePlaceholders:
type: object
additionalProperties:
type: string
description: 'Key value pairs that will be replaced when using personalized opt out landing page. Placeholder keys should NOT contain curly brackets and should NOT contain a `pin` placeholder. Valid example: `"landingPagePlaceholders":{"name":"John", "surname": "Smith"}`'
readOnly: false
writeOnly: true
messageId:
type: string
description: The ID of the Email message template (message with the PIN placeholder) that is sent to the recipient.
readOnly: false
writeOnly: false
placeholders:
type: object
additionalProperties:
type: string
description: 'Key value pairs that will be replaced during message sending. Placeholder keys should NOT contain curly brackets and should NOT contain a `pin` placeholder. Valid example: `"placeholders":{"firstName":"John"}`'
readOnly: false
writeOnly: false
to:
type: string
description: 'Email address to which the 2FA message will be sent. Example: john.smith@example.com.'
readOnly: false
writeOnly: false
required:
- applicationId
- messageId
- to
title: StartEmailAuthenticationRequest
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.DeliveryTimeWindowResponse:
type: object
description: Used to specify a time-window in which a response message is allowed to be sent. If not defined there is no limitation when message will be sent.
properties:
from:
type: string
description: Exact time of day in which the sending can start. Consists of hour and minute properties, both mandatory. Time is expressed in the UTC time zone. Formatted as HH:mm.
example: 08:35
to:
type: string
description: Exact time of day in which the sending will end. Consists of an hour and minute properties, both mandatory. Time is expressed in the UTC time zone. Formatted as HH:mm.
example: '16:35'
days:
type: array
description: Days which are included in the delivery time window.
items:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.DayOfWeek'
uniqueItems: true
deliveryTimeZone:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.DeliveryTimeZoneResponse'
required:
- days
- deliveryTimeZone
- from
- to
title: DeliveryTimeWindowResponse
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignNetworkStatusWebhookMessage:
type: object
description: Incoming events
properties:
event:
type: string
description: The name of the event.
enum:
- CAMPAIGN_NETWORK_STATUS_UPDATE
example: CAMPAIGN_NETWORK_STATUS_UPDATE
receivedAt:
type: string
format: date-time
description: Date and time when Infobip received the event.
content:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignNetworkStatusWebhookContent'
platform:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignWebhookPlatform'
title: CampaignNetworkStatusWebhookMessage
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.TollFreeUseCase:
type: string
description: Campaign use case.
enum:
- TWO_FA
- APP_NOTIFICATIONS
- APPOINTMENTS
- AUCTIONS
- AUTO_DEALERSHIP_SERVICES
- BANKING
- BILLING
- BOOKING_CONFIRMATIONS
- BUSINESS_UPDATES
- COVID_19_ALERTS
- CAREER_TRAINING
- CHATBOT
- CONVERSATIONAL_ALERTS
- COURIER_SERVICES_DELIVERIES
- EDUCATIONAL
- EMERGENCY_ALERTS
- EMPLOYEE_ALERTS_NOTIFICATIONS
- EVENTS_PLANNING
- FINANCIAL_SERVICES
- FRAUD_ALERTS
- FUNDRAISING
- GENERAL_MARKETING
- HR_STAFFING
- HEALTHCARE
- HOUSING_COMMUNITY_UPDATES
- INSURANCE_SERVICES
- JOB_ALERTS
- LEGAL_SERVICES
- MIXED
- MOTIVATIONAL_REMINDERS
- NOTARY_NOTIFICATIONS
- NOTIFICATIONS
- ORDER_NOTIFICATIONS
- POLITICAL
- PUBLIC_WORKS
- REAL_ESTATE_SERVICES
- RECEIPT_NOTIFICATIONS
- RELIGIOUS_SERVICES
- REPAIR_DIAGNOSTICS_ALERTS
- REWARDS_PROGRAM
- SURVEYS
- SYSTEM_ALERTS
- WAITLIST_ALERTS
- WEBINAR_REMINDERS
- WORKSHOP_ALERTS
title: TollFreeUseCase
c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.IndiaDltOptions:
type: object
properties:
contentTemplateId:
type: string
description: Registered DLT content template ID which matches message you are sending.
maxLength: 30
minLength: 0
readOnly: false
writeOnly: false
principalEntityId:
type: string
description: Your assigned DLT principal entity ID.
maxLength: 30
minLength: 0
readOnly: false
writeOnly: false
teleMarketerId:
type: string
description: Your assigned Telemarketer ID (required for Aggregators).
maxLength: 255
minLength: 0
readOnly: false
writeOnly: false
required:
- principalEntityId
title: IndiaDltOptions
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.FilledRequirementFeedback:
type: object
description: List of feedback for requirements.
properties:
key:
type: string
description: Key of the requirement for which feedback is provided.
code:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.FeedbackCode'
feedback:
type: string
description: Feedback for the requirement.
title: FilledRequirementFeedback
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.RegionalOptions:
type: object
description: Region-specific parameters, often imposed by local laws. Use this, if country or region that you are sending an SMS to requires additional information.
properties:
indiaDlt:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.IndiaDltOptions'
turkeyIys:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.TurkeyIysOptions'
southKorea:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.SouthKoreaOptions'
title: RegionalOptions
17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationRequest:
type: object
properties:
configuration:
allOf:
- $ref: '#/components/schemas/17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationConfiguration'
description: Created 2FA application configuration.
readOnly: false
writeOnly: true
enabled:
type: boolean
description: Indicates whether the created application is enabled.
readOnly: false
writeOnly: true
name:
type: string
description: 2FA application name.
readOnly: false
writeOnly: true
required:
- name
title: ApplicationRequest
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.OptIns:
type: object
properties:
keyword:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.KeywordOptIn'
web:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.WebOptIn'
verbal:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.VerbalOptIn'
interactiveVoiceResponse:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.InteractiveVoiceResponseOptIn'
title: OptIns
e8b4ac5a98b4fdd5509637ee70be50d1c508e5a4c9ac2c19485e7cdc7eb9bd4e.ApiException:
type: object
properties:
requestError:
$ref: '#/components/schemas/ApiRequestError'
title: ApiException
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.AppealDocument:
type: object
description: A document attached to a brand identity appeal.
properties:
documentId:
type: string
format: uuid
description: ID of the previously uploaded document.
documentType:
type: string
description: Classification of the document type. Defaults to OTHER if not specified.
enum:
- IRS_CP575
- OTHER
required:
- documentId
title: AppealDocument
c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.UpdateEmailMessageRequest:
type: object
properties:
emailTemplateId:
type: integer
format: int64
description: Email template ID that should reference a previously created Email template.
readOnly: false
writeOnly: false
from:
type: string
description: The sender of the 2FA message, an email address with an optional sender name (e.g. `company@example.com` or `Jane Smith platform. If an empty list is sent all current permissions assigned to api key will be removed and 'PUBLIC_API' will be set as default.
enum:
- PUBLIC_API
- 2FA_CLIENT
- WEB_SDK
items:
type: string
description: List of permissions this API key has granted. Default permission is 'PUBLIC_API'. API key cannot be created with both 'PUBLIC_API' and WEB_SDK permissions. API key cannot be updated with both permissions and a collection of Applications and/or Entities in platform. If an empty list is sent all current permissions assigned to api key will be removed and 'PUBLIC_API' will be set as default.
enum:
- PUBLIC_API
- 2FA_CLIENT
- WEB_SDK
platform:
type: array
description: A collection of CPaaS X Applications and Entities that will be linked to the API key. All Applications and Entities will be removed from the api key if an empty platform list is sent and 'PUBLIC_API' will be assigned as default permission. Or, to remove a specific Application/Entity pair, omit it from the platform list.
externalDocs:
description: 'WARNING: linking an existing API Key to an Application and/or Entity will limit access to these endpoints.'
url: https://www.infobip.com/docs/cpaas-x/application-and-entity-management#api-keys-endpoints-list-api-keys-with-application-and-entity
items:
$ref: '#/components/schemas/bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.Platform'
scopeGuids:
type: array
description: List of [API scopes](https://www.infobip.com/docs/essentials/api-essentials/api-authorization#available-api-scopes-api-scopes) that will be assigned to the API key. An API key cannot be updated with both scopes and a collection of Applications and/or Entities in platform. If an empty list is sent, all current scopes assigned to the API Key will be removed and it will no longer be able to access any API endpoint.
items:
type: string
description: List of [API scopes](https://www.infobip.com/docs/essentials/api-essentials/api-authorization#available-api-scopes-api-scopes) that will be assigned to the API key. An API key cannot be updated with both scopes and a collection of Applications and/or Entities in platform. If an empty list is sent, all current scopes assigned to the API Key will be removed and it will no longer be able to access any API endpoint.
uniqueItems: true
title: UpdateApiKeyRequest
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignStatusWebhookContent:
type: object
description: Event content.
properties:
campaignId:
type: string
format: uuid
description: The ID of campaign.
example: 38a1c2c6-55f2-11ee-a061-325096b39f47
tcrId:
type: string
description: The ID of the campaign as defined by The Campaign Registry. This field is present only for 10DLC campaigns.
example: C0O3XVU
campaignStatus:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.WebhookCampaignStage'
rejectionReasons:
type: string
description: The rejection reasons. This field is present only when new campaign registration status is 'REJECTED'.
example: Unable to verify, need website.
rejectionDetails:
type: array
description: The rejection reasons details. This field is present only when new campaign registration status is 'REJECTED'.
items:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.RejectionReasonPayload'
rejectionDate:
type: string
format: date-time
description: The rejection date. This field is present only when new campaign registration status is 'REJECTED'.
title: CampaignStatusWebhookContent
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CustomerEngagementSubscriptionRequest:
type: object
description: Subscription group.
properties:
subscriptionId:
type: string
description: Subscription ID. Used as part of a URL path and must not include any characters that require URL encoding. You cannot change the ID once a subscription is created.
maxLength: 255
minLength: 1
name:
type: string
description: A human-readable description for your subscription, can be changed at a later point.
maxLength: 255
minLength: 1
events:
type: array
description: List of events available for a subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](https://www.infobip.com/docs/cpaas-x/subscriptions-management/event-subscriptions). If configuring inbound Subscription, check [inbound message configuration docs](https://www.infobip.com/docs/cpaas-x/subscriptions-management/inbound-message-configuration).
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleCustomerEngagementEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfileRequest'
required:
- events
- profile
- subscriptionId
title: Customer Engagement
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.FilledRequirementFeedbackApiDoc:
type: object
description: Feedback for requirements. Present only for UPDATE_REQUESTED and UPDATE_REQUESTED_BY_INTERNAL_REVIEWER statuses.
properties:
key:
type: string
description: Key of the requirement for which feedback is provided.
code:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.FeedbackCode'
feedback:
type: string
description: Feedback for the requirement.
title: FilledRequirementFeedbackApiDoc
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleRcsEvents:
type: string
enum:
- CAP_CHECK
- CLICK
- CONVERSATION_STARTED
- DELIVERY
- INBOUND_MESSAGE
- SEEN
- SENDER_LAUNCH_UPDATE
- SENDER_UPDATE
- SUGGESTION
- TEMPLATE_UPDATE
- TEST_NUMBER_UPDATE
- TYPING_INDICATOR
title: Event
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.EmailNoIdSubscriptionRequest:
type: object
description: Subscription group.
properties:
name:
type: string
description: Subscription group name.
maxLength: 255
minLength: 1
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyProfileRequest'
events:
type: array
description: List of events available for subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](/docs/cpaas-x/subscriptions-management#availability). In case you are configuring inbound Subscription please check all the details [available here](/docs/cpaas-x/subscriptions-management#inbound-message-configuration).
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleEmailEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
required:
- events
- profile
title: Email
4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611.CnamDelivery:
type: object
description: CNAM Delivery is enabled on your DID at an additional charge that allows you to see the caller identification of the person calling you.
properties:
enabled:
type: boolean
default: false
description: Indicates whether configuration is enabled or not.
title: CnamDelivery
99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.QueryAggregateDataResult:
type: object
properties:
requestId:
type: string
description: The identifier of original request returned by [Query aggregated traffic data](#platform/metrics-api/query-aggregate-data) endpoint.
status:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.QueryAggregateDataStatus'
response:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.AggregateDataResponse'
failureMessage:
type: string
description: The message describing the failure. This field is present only if the request failed.
required:
- requestId
- status
title: QueryAggregateDataResult
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.TenDlcUseCase:
type: string
description: Campaign use case.
enum:
- ALERTS
- CHAT
- DONATION
- EDUCATION
- FRAUD_ALERTS
- PROMOTIONAL_MARKETING
- PUBLIC_SERVICE_ANNOUNCEMENT
- TWO_FACTOR_AUTH
- VOTING_POLLING
- POLITICAL
- M2M
- SWEEPSTAKE
title: TenDlcUseCase
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandType:
type: string
description: The type of brand.
enum:
- TENDLC_NON_PROFIT
- TENDLC_PRIVATE_COMPANY
- TENDLC_PUBLIC_COMPANY
- TENDLC_GOVERNMENT
title: BrandType
2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.ToDelete:
type: object
description: To.
properties:
to:
type: string
description: 'Destination address that needs to be removed from blocklist. Addresses must be a number in international format (example: `41793026727`), a valid email address (example: `recipient@example.com`) or valid email domain (example: `example.com`).'
maxLength: 255
minLength: 1
required:
- to
title: ToDelete
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.KakaoBrandMessageSubscriptionRequest:
type: object
description: Subscription group.
properties:
subscriptionId:
type: string
description: Subscription ID. Used as part of a URL path and must not include any characters that require URL encoding. You cannot change the ID once a subscription is created.
maxLength: 255
minLength: 1
name:
type: string
description: A human-readable description for your subscription, can be changed at a later point.
maxLength: 255
minLength: 1
events:
type: array
description: List of events available for a subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](https://www.infobip.com/docs/cpaas-x/subscriptions-management/event-subscriptions). If configuring inbound Subscription, check [inbound message configuration docs](https://www.infobip.com/docs/cpaas-x/subscriptions-management/inbound-message-configuration).
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleKakaoBrandMessageEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfileRequest'
required:
- events
- profile
- subscriptionId
title: Kakao Brand Message
bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.PagingResponse:
type: object
properties:
page:
type: integer
format: int32
pageSize:
type: integer
format: int32
orderDirection:
type: string
orderBy:
type: string
totalCount:
type: integer
format: int64
totalPages:
type: integer
format: int32
title: PagingResponse
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.IbResourceCoverage:
type: object
description: Information about the networks configured for the resource.
properties:
outbound:
type: array
items:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.NetworkView'
uniqueItems: true
inbound:
type: boolean
description: Indicates if inbound configuration exists.
example: false
title: IbResourceCoverage
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleKakaoBrandMessageEvents:
type: string
enum:
- CLICK
- DELIVERY
title: Event
ApiRequestErrorDetails:
type: object
properties:
messageId:
type: string
description: Identifier of the error.
text:
type: string
description: Detailed error description.
validationErrors:
type: object
additionalProperties:
type: array
items:
type: string
description: Validation errors.
description: Validation errors.
title: ApiRequestErrorDetails
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateButtonType:
type: string
enum:
- QUICK_REPLY
- OPEN_URL
- PHONE_NUMBER
- FLOW
- COPY_CODE
- CATALOG
- MULTI_PRODUCT
title: MessagesApiTemplateButtonType
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageButton:
type: object
description: List of buttons of the message.
discriminator:
propertyName: type
mapping:
REPLY: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageReplyButton'
OPEN_URL: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageOpenUrlButton'
DIAL_PHONE: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageDialPhoneButton'
SHOW_LOCATION: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageShowLocationButton'
REQUEST_LOCATION: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageRequestLocationButton'
ADD_CALENDAR_EVENT: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageAddCalendarEventButton'
properties:
type:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageButtonType'
required:
- type
title: MessagesApiMessageButton
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiSeenReport:
type: object
properties:
results:
type: array
description: Collection of reports, one per every message.
items:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiSeenResult'
required:
- results
title: MessagesApiSeenReport
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BusinessRegistrationType:
type: string
description: 'Type of tax identification number provided. Value depend on selected taxId issuing country. For US it can be only EIN.
Not required for sole proprietor brands.'
enum:
- EIN
- CBN
- NEQ
- PROVINCIAL_NUMBER
- CRN
- VAT
- ACN
- ABN
- BRN
- SIREN
- SIRET
- NZBN
- UST_IDNR
- CIF
- NIF
- CNPJ
- UID
- OTHER
title: BusinessRegistrationType
b1075107f5bba728f6a701eb8a72357dfcf0d9c4405dd06e85e56496153a8d2f.OAuthApiException:
type: object
properties:
error:
type: string
description: Deprecated, use requestError field instead. Shows error message.
requestError:
$ref: '#/components/schemas/ApiRequestError'
title: OAuthApiException
bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.AccountsResponse:
type: object
properties:
accounts:
type: array
description: List of accounts
items:
$ref: '#/components/schemas/bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.Account'
title: AccountsResponse
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandAppealPreview:
type: object
description: Summary information about a single brand appeal.
properties:
appealId:
type: string
format: uuid
description: Unique identifier of the appeal.
status:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandAppealStatus'
submittedAt:
type: string
format: date-time
description: Timestamp when the appeal was submitted.
rejectionReason:
type: string
description: Reason for rejection. Present only when the appeal status is REJECTED.
title: BrandAppealPreview
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.ShortCodeUseCase:
type: string
description: Campaign use case.
enum:
- ALERTS
- CHAT
- DONATION
- EDUCATION
- FRAUD_ALERTS
- PROMOTIONAL_MARKETING
- PUBLIC_SERVICE_ANNOUNCEMENT
- SWEEPSTAKES_CONTEST
- TWO_FACTOR_AUTH
- VOTING_POLLING
- POLITICAL
- EMERGENCY_NOTIFICATIONS
- DELIVERY_NOTIFICATIONS
- SECURITY_ALERT
title: ShortCodeUseCase
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.PlatformDocs:
type: object
description: Platform applicationId and entityId to apply to inbound messages that pair to this configuration. If not provided, or if set to default values (applicationId = default and entityId = null), values from the associated number/resource will be used.
externalDocs:
description: Find out more about Application and Entity Management
url: https://www.infobip.com/docs/api/platform/application-entity
properties:
applicationId:
type: string
description: Platform applicationId.
example: myApplicationId
maxLength: 255
minLength: 0
entityId:
type: string
description: Platform entityId.
example: myEntityId
maxLength: 255
minLength: 0
title: PlatformDocs
2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.DeletableChannel:
type: string
description: Channel for which blocklist record/s will be removed.
enum:
- SMS
- EMAIL
- VIBER
- RCS
- MMS
- APPLE_MB
- WHATSAPP
title: DeletableChannel
2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.Content:
type: object
description: Event content.
properties:
sender:
type: string
description: The sender ID for which blocklist happened.
destination:
type: string
description: Blocklisted destination address.
channel:
$ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.ViewableChannel'
sourceType:
$ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.EventSourceType'
outboundMessageReference:
$ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.OutboundMessageReference'
inboundMessageReference:
$ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.InboundMessageReference'
campaignReference:
$ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.CampaignReference'
required:
- destination
- sourceType
title: Content
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.RequirementSpec:
type: object
description: List of requirements needed for the resource request.
discriminator:
propertyName: type
mapping:
TEXT: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.TextRequirementSpec'
INTEGER: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.IntegerRequirementSpec'
EMAIL: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.EmailRequirementSpec'
URL: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.UrlRequirementSpec'
GSM: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.GsmRequirementSpec'
DOCUMENT: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.DocumentRequirementSpec'
properties:
type:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.FieldType'
title: RequirementSpec
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.VerbalOptIn:
type: object
description: The type of opt in that requires a user to verbally confirm.
properties:
callToAction:
type: string
description: " The message sent to the user to tell them how to subscribe. Must include:\n • Product description\n • Message frequency disclosure\n • Complete terms and conditions OR link to complete terms and conditions\n • Privacy policy OR link to privacy policy\n • STOP keyword\n • The \"Message and data rates may apply\" disclosure\n"
maxLength: 1024
minLength: 20
required:
- callToAction
title: VerbalOptIn
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandAppealResponse:
type: object
description: Response returned after successfully submitting a brand identity appeal.
properties:
appealId:
type: string
format: uuid
description: Unique identifier assigned to the submitted appeal.
title: BrandAppealResponse
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MoNonForwardAction:
type: object
description: List of other configured actions on this keyword. Ignored in POST/PUT calls.
discriminator:
propertyName: type
mapping:
AUTORESPONSE: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.AutoResponseAction'
BLOCK: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.BlockAction'
properties:
type:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MoActionType'
editable:
type: boolean
description: Flag which indicates if given action is editable. Ignored on POST/PUT requests.
readOnly: true
readOnly: true
required:
- type
title: MoNonForwardAction
2be764ef53499e28cc8da8dff3890f0787860aba10984e520352c73612c0342b.Application:
type: object
properties:
applicationName:
type: string
description: Descriptive name of the resource.
example: Test name
maxLength: 255
applicationId:
type: string
description: The unique identifier of the application. This ID will be a URL path parameter. We recommend using values that do not need URL encoding for easier interaction with other API endpoints.
example: test-application
maxLength: 255
required:
- applicationId
title: Application
e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.UpdateCatalogFieldDto:
type: object
properties:
name:
type: string
description: Field name.
example: Custom label
required:
- name
title: UpdateCatalogFieldDto
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessageDestination:
type: object
description: Array of destination objects for where messages are being sent. A valid destination is required. **`Channels Destination` is required when sending messages with defined failover.**
oneOf:
- $ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiChannelsDestination'
- $ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiToDestination'
title: MessageDestination
c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.PinType:
type: string
enum:
- NUMERIC
- ALPHA
- HEX
- ALPHANUMERIC
title: PinType
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.BlocklistNoIdSubscriptionRequest:
type: object
description: Subscription group.
properties:
name:
type: string
description: Subscription group name.
maxLength: 255
minLength: 1
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyProfileRequest'
events:
type: array
description: List of events available for subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](/docs/cpaas-x/subscriptions-management#availability). In case you are configuring inbound Subscription please check all the details [available here](/docs/cpaas-x/subscriptions-management#inbound-message-configuration).
items:
oneOf:
- $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleBlocklistEvents'
- $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.FormatAwareBlocklistEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
required:
- events
- profile
title: Blocklist
2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.OutboundMessageReference:
type: object
description: Outbound message reference, if matched by the Infobip platform.
properties:
bulkId:
type: string
description: ID of the bulk of outgoing messages.
outboundMessageId:
type: string
description: ID of the paired outgoing message.
sendAt:
type: string
format: date-time
description: Date and time when the bulk or message was scheduled to be sent.
title: OutboundMessageReference
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.NetworkView:
type: object
description: Network data.
properties:
mccNnc:
type: string
description: Norm net code uniquely identifying the specific mobile network operator.
example: '310260'
networkName:
type: string
description: Network name.
example: Some network
title: NetworkView
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiInboundEvent:
type: object
description: Incoming messages
discriminator:
propertyName: event
mapping:
MO: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMoEvent'
TYPING_STARTED: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiInboundTypingStartedEvent'
TYPING_STOPPED: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiInboundTypingStoppedEvent'
properties:
event:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiInboundEventType'
required:
- event
title: MessagesApiInboundEvent
aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6e.VerificationResponse:
type: object
properties:
verifications:
type: array
description: Collection of verifications
items:
$ref: '#/components/schemas/aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6e.Verification'
readOnly: true
writeOnly: false
title: VerificationResponse
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignAiBuilderWebhookContent:
type: object
description: Event content.
properties:
aiCampaignBuilderRequestUuid:
type: string
format: uuid
description: Unique identifier of the AI campaign builder request, matching the requestUuid returned when the campaign builder was started.
title: CampaignAiBuilderWebhookContent
99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.BillingUsageAggregate:
type: string
enum:
- DAY
- MONTH
- APPLICATION_ID
- ENTITY_ID
- ACCOUNT_NAME
- ACCOUNT_KEY
- CATEGORY_CODE
- CATEGORY_NAME
- SUBCATEGORY_CODE
- SUBCATEGORY_NAME
- USER_NAME
- DIRECTION
- TRAFFIC_TYPE
- SENDER
- SENDER_TYPE
- NETWORK_NAME
- NORM_NET_CODE
- COUNTRY_NAME
- COUNTRY_CODE
- COUNTRY_PREFIX
- CAMPAIGN_ID
- CAMPAIGN_REFERENCE
- TEMPLATE_ID
title: BillingUsageAggregate
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandVetStatusWebhookMessage:
type: object
description: Incoming events
properties:
event:
type: string
description: The name of the event.
enum:
- BRAND_VET_UPDATE
example: BRAND_VET_UPDATE
receivedAt:
type: string
format: date-time
description: Date and time when Infobip received the event.
content:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandVetStatusWebhookContent'
platform:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandWebhookPlatform'
title: BrandVetStatusWebhookMessage
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.MobilePushSubscriptionRequest:
type: object
description: Subscription group.
properties:
subscriptionId:
type: string
description: Subscription ID. Used as part of a URL path and must not include any characters that require URL encoding. You cannot change the ID once a subscription is created.
maxLength: 255
minLength: 1
name:
type: string
description: A human-readable description for your subscription, can be changed at a later point.
maxLength: 255
minLength: 1
events:
type: array
description: List of events available for a subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](https://www.infobip.com/docs/cpaas-x/subscriptions-management/event-subscriptions). If configuring inbound Subscription, check [inbound message configuration docs](https://www.infobip.com/docs/cpaas-x/subscriptions-management/inbound-message-configuration).
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleMobilePushEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfileRequest'
required:
- events
- profile
- subscriptionId
title: Mobile Push
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleMobilePushEvents:
type: string
enum:
- DELIVERY
- SEEN
- SENT
title: Event
17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationConfiguration:
type: object
properties:
allowMultiplePinVerifications:
type: boolean
default: true
description: Indicates whether multiple PIN verification is allowed.
readOnly: false
writeOnly: false
pinAttempts:
type: integer
format: int32
default: 10
description: Number of possible PIN attempts.
readOnly: false
writeOnly: false
pinTimeToLive:
type: string
default: 15m
description: 'Validity period of PIN in specified time unit. Required format: `{timeLength}{timeUnit}`. `timeLength` is optional with a default value of 1. `timeUnit` can be set to: `ms`, `s`, `m`, `h` or `d` representing milliseconds, seconds, minutes, hours, and days respectively. Must not exceed one year, although much lower value is recommended.'
readOnly: false
writeOnly: false
sendPinPerApplicationLimit:
type: string
default: 10000/1d
description: 'Overall number of requests over a specified time period for generating a PIN and sending a message using a single application. Required format: `{attempts}/{timeLength}{timeUnit}`. `attempts` and `timeunit` are mandatory and `timeLength` is optional with a default value of 1. `timeUnit` is one of: `ms`, `s`, `m`, `h` or `d` representing milliseconds, seconds, minutes, hours, and days respectively. Must not exceed one year, although much lower value is recommended.'
readOnly: false
writeOnly: false
sendPinPerPhoneNumberLimit:
type: string
default: 3/1d
description: 'Number of requests over a specified time period for generating a PIN and sending a message to one destination. Required format: `{attempts}/{timeLength}{timeUnit}`. `attempts` and `timeunit` are mandatory and `timeLength` is optional with a default value of 1. `timeUnit` is one of: `ms`, `s`, `m`, `h` or `d` representing milliseconds, seconds, minutes, hours, and days respectively. Must not exceed one year, although much lower value is recommended.'
readOnly: false
writeOnly: false
verifyPinLimit:
type: string
default: 1/3s
description: 'The number of PIN verification requests over a specififed time period from one phone number (MSISDN). Required format: `{attempts}/{timeLength}{timeUnit}`. `attempts` and `timeunit` are mandatory and `timeLength` is optional with a default value of 1. `timeUnit` is one of: `ms`, `s`, `m`, `h` or `d` representing milliseconds, seconds, minutes, hours, and days respectively. Must not exceed one day, although much lower value is recommended.'
readOnly: false
writeOnly: false
title: ApplicationConfiguration
99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.AggregateDataRequest:
type: object
properties:
filterBy:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.AggregateDataFilter'
aggregateBy:
type: array
description: "\nAn array of strings that defines the properties used for data aggregation. Each item in the array represents an aggregation parameter, with a corresponding column in the response showing values for the chosen aggregate.\n`CHANNEL_CODE` is always included in results for metric accuracy, even if not specified in aggregateBy. For further details,\nrefer to our [documentation](https://www.infobip.com/docs/metrics-api/metrics-and-filters#aggregationdimensions).\n\nAvailable aggregates:\n* `ACCOUNT_KEY` - groups the results by account key, displaying account-specific values.\n* `HOUR` - groups the results by hour, showing corresponding hourly timestamp values.\n* `DAY` - groups the results by day, showing corresponding day values.\n* `WEEK_SATURDAY_START` - groups the results by week, starting on Saturday, with corresponding timestamp values.\n* `WEEK_SUNDAY_START` - groups the results by week, starting on Sunday, with corresponding timestamp values.\n* `WEEK_MONDAY_START` - groups the results by week, starting on Monday, with corresponding timestamp values.\n* `MONTH` - groups the results by month, showing monthly values.\n* `QUARTER` - groups the results by quarter, showing quarterly values.\n* `YEAR` - groups the results by year, displaying annual values.\n* `TIME_TO_DELIVER` - groups the results by message delivery time, showing time-to-deliver period descriptions.\n* `TIME_TO_ANSWER` - groups the results by call answer time, showing time-to-answer period descriptions.\n* `TIME_TO_CLICK_FROM_SEEN` - groups the results by the time (in seconds) between a message being seen and a URL being clicked, showing calculated values.\n* `TIME_TO_CLICK_FROM_DELIVERED` - groups the results by the time (in seconds) between message delivery and a URL being clicked, showing calculated values.\n* `TIME_TO_SEEN_FROM_DELIVERED` - groups the results by the time (in seconds) between message delivery and the message being seen, showing calculated values.\n* `TIME_TO_OPEN_FROM_DELIVERED` - groups the results by the time (in seconds) between message delivery and the message being opened, showing calculated values.\n* `CHANNEL_CODE` - groups the results by channel, showing corresponding channel code values.\n* `CHANNEL_NAME` - groups the results by channel name, showing corresponding channel name values.\n* `CAPABILITY` - groups the results by capability, showing corresponding capability code values.\n* `DIRECTION` - groups the results by traffic direction, showing whether it was OUTBOUND (sent to a client) or INBOUND (received from a client).\n* `TRAFFIC_TYPE` - groups the results by traffic type, showing specific traffic type values.\n* `SENDER` - groups the results by sender, showing sender-specific values.\n* `SENDER_TYPE` - groups the results by type of sender, showing sender type values.\n* `SENDER_DOMAIN` - groups the results by sender domain, showing domain-specific values.\n* `RECIPIENT_DOMAIN` - groups the results by recipient domain, showing domain-specific values.\n* `URL` - groups the results by initial URL in a message, showing URL-specific values.\n* `COMMUNICATION` - groups the results by communication ID, showing the unique ID associated with each message.\n* `CAMPAIGN_REFERENCE` - groups the results by campaign reference ID, showing associated campaign reference values.\n* `NETWORK_ID` - groups the results by network, showing network ID values.\n* `NETWORK_NAME` - groups the results by network name, showing the name associated with each network ID.\n* `COUNTRY_ID` - groups the results by country, showing country ID values.\n* `COUNTRY_NAME` - groups the results by country name, showing the name associated with each country.\n* `APPLICATION_ID` - groups the results by application, showing corresponding application ID values.\n* `ENTITY_ID` - groups the results by entity, showing corresponding entity ID values.\n* `STATUS_GROUP` - groups response results by status group, showing corresponding status group values.\n* `STATUS` - groups response results by status name, showing corresponding status values.\n* `ERROR_GROUP` - groups response results by error group, showing corresponding error group values.\n* `ERROR_CODE` - groups response results by error code, showing corresponding error code values.\n "
items:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.TrafficAggregate'
uniqueItems: true
metrics:
type: array
description: "\nThe metrics parameter accepts an array of non-empty strings that specify the metrics to retrieve. Each column in the response will contain values corresponding to the selected metric type.\n\nFor detailed information on the metrics available through the API, including specific details, limitations, and channel applicability, please refer to our comprehensive\n[documentation](https://www.infobip.com/docs/metrics-api/metrics-and-filters) on available metrics.\n\nAvailable metrics:\n* `TOTAL_TRAFFIC_COUNT` - Total number of messages or message segments sent to and received from customers (inbound and outbound).\n* `TOTAL_ACCEPTED_TRAFFIC_COUNT` - The total number of accepted Email messages sent to your customers (outbound).\n* `TOTAL_SMS_MESSAGES_COUNT` - Total number of SMS messages sent to and received from customers (inbound and outbound). Messages split into multiple segments due to length are counted as a single distinct message.\n* `INTERACTION_COUNT` - Number of distinct messaging interactions. Combined with the `TRAFFIC_TYPE` dimension, it helps analyze specific messaging traffic by breaking down interactions into different WhatsApp or RCS categories, such as conversations or sessions.\n* `TOTAL_SENT_TRAFFIC_COUNT` - Total number of messages submitted for delivery (outbound).\n* `DELIVERED_TRAFFIC_COUNT` - Total number of messages delivered to a recipient.\n* `TRAFFIC_DELIVERY_RATE` - Percentage of messages successfully delivered to recipients. Calculated using the formula: Total delivered / (Total sent - Total rejected) for all channels except Email, where it is calculated as Total delivered / Total sent.\n* `TRAFFIC_DELIVERED_IN_5_SEC_RATE` - Percentage of messages delivered within a 5-second timeframe.\n* `TOTAL_RECEIVED_TRAFFIC_COUNT` - Total number of messages received from customers (inbound).\n* `RECEIVED_TO_SENT_TRAFFIC_RATIO` - Ratio of received (inbound) to sent (outbound) messages that were not rejected.\n* `FAILED_TRAFFIC_COUNT` - Total number of sent (outbound) messages that were not delivered to recipients.\n* `TOTAL_BOUNCE_COUNT` - Total number of emails not delivered, including soft (temporary) and hard (permanent) bounces.\n* `TOTAL_BOUNCE_RATE` - Percentage of emails that were not delivered, calculated by summing soft and hard bounces and dividing by the total sent.\n* `TOTAL_DROPPED_COUNT` - Submitted emails that were dropped before delivery due to factors such as unsubscribes, bounced addresses, spam marking, or sender errors.\n* `TOTAL_DROPPED_RATE` - Percentage of dropped emails, calculated by dividing the number of dropped emails by the accepted emails.\n* `TOTAL_SUPPRESSED_COUNT` - Number of emails not sent due to a bounce or recipient actions like spam marking.\n* `SOFT_BOUNCE_COUNT` - Number of emails temporarily undeliverable due to reasons like full inboxes, temporary domain unavailability, or lack of recipient opt-in.\n* `SOFT_BOUNCE_RATE` - Percentage of temporarily undeliverable emails, calculated by dividing soft bounces by total sent.\n* `HARD_BOUNCE_COUNT` - Number of emails permanently undeliverable to specific recipients.\n* `HARD_BOUNCE_RATE` - Percentage of permanently undeliverable emails, calculated by dividing hard bounces by total sent.\n* `SEEN_OPENED_TRAFFIC_COUNT` - Total number of messages seen or opened. Recipients can turn off their read receipts, resulting in a lower seen count.\n* `SEEN_OPENED_TRAFFIC_RATE` - Percentage of messages seen or opened by unique recipients. Recipients can turn off their read receipts, resulting in a lower seen rate.\n* `VIEWED_TOTAL_COUNT` - Number of email opens per recipient, including multiple opens by the same user.\n* `VIEWED_TOTAL_RATE` - Percentage of recipients who opened an email campaign.\n* `UNIQUE_CLICKS_COUNT` - Number of unique recipients who clicked any link in a message, counted only once per recipient regardless of multiple clicks.\n* `UNIQUE_CLICK_THROUGH_RATE` - Percentage of unique recipients who clicked a link compared to total messages delivered, counting each recipient only once.\n* `UNIQUE_URL_CLICK_COUNT` - Number of unique URLs clicked in a single message.\n* `CLICK_TO_OPEN_RATE` - Percentage of unique clicks divided by unique opens or views, counting each recipient only once.\n* `TOTAL_CLICKS_COUNT` - Total clicks on all URLs in a message, including multiple clicks on the same link. For example, if a message contains 3 links and each is clicked twice, the total clicks count is 6.\n* `TOTAL_CLICK_RATE` - Percentage of recipients who clicked any link, calculated as the total clicks across all URLs divided by the total delivered messages. For example, if 200 SMS messages are sent and there are 400 total clicks, the `TOTAL_CLICK_RATE` is 200%.\n* `UNSUBSCRIBED_USER_COUNT` - Number of recipients who unsubscribed (opted out) from further communications from the sender.\n* `UNSUBSCRIBED_USER_RATE` - Percentage of recipients who unsubscribed (opted out) from further communications from the sender.\n* `EMAIL_COMPLAINTS_COUNT` - Number of emails reported as spam by recipients.\n* `EMAIL_COMPLAINTS_RATE` - Percentage of emails reported as spam by recipients.\n* `TOTAL_CALL_COUNT` - Total number of calls sent to your customers (outbound) and calls received from your customers (inbound).\n* `TOTAL_ATTEMPTED_CALL_COUNT` - Total number of calls initiated for delivery (outbound).\n* `TOTAL_SEIZED_CALL_COUNT` - Total number of calls that have successfully reached the recipient's device and started ringing, regardless of whether they were ultimately answered or not.\n* `TOTAL_ANSWERED_CALL_COUNT` - Total number of calls that were successfully answered, including both inbound calls (initiated by the customer) and outbound calls (initiated by the business).\n* `TOTAL_RECEIVED_CALL_COUNT` - Total number of calls you received from customers (inbound).\n* `AMD_PROCESSED_CALL_COUNT` - The number of calls that used Automated machine detection.\n* `ANSWERED_BY_PERSON_CALL_COUNT` - Number of calls initiated by the business that were successfully answered by a person (human).\n* `ANSWERED_BY_VOICE_DETECTION_CALL_COUNT` - Number of calls initiated by the business that were successfully answered by a voice detection system (e.g., voicemail, automated system).\n* `NOT_ANSWERED_CALL_COUNT` - Total number of outbound calls that were not answered by the recipient.\n* `BUSY_CALL_COUNT` - Total number of outbound calls that received a busy signal or were rejected due to the recipient's line being busy.\n* `CANCELED_CALL_COUNT` - Total number of outbound calls that were canceled at the origination end before they could have been successfully routed to the end user.\n* `FAILED_CALL_COUNT` - Total number of calls that were not successfully delivered for various reasons, including being declined or rejected by the user, rejected by the operator, or due to the end user's unavailability to receive the call at the time of the attempt.\n* `ANSWER_SEIZURE_RATIO` - The percentage of successfully answered calls out of the total number of call attempts that resulted in a seizure (i.e., a call attempt that resulted in a ring-back tone).\n* `ANSWER_RATE` - The percentage of calls that are successfully answered by the called party out of the total number of calls that were attempted.\n* `BUSY_RATE` - The percentage of calls that receive a busy signal out of the total number of attempted calls.\n* `HUNG_UP_COUNT` - The total number of call or session terminations, including those initiated by users after successful interactions and those caused by system errors.\n* `NORMAL_HUNG_UP_COUNT` - The number of regular call or session terminations initiated by users after successful interactions.\n* `ERROR_HUNG_UP_COUNT` - The number of call or session terminations caused by encountered errors within the system.\n* `TOTAL_CALL_DURATION` - The cumulative duration of all calls made to and received from customers (inbound and outbound).\n\nFor more detailed information and examples, please visit:\n- [Metrics and Filters](https://www.infobip.com/docs/metrics-api/metrics-and-filters#metrics)\n- [Constraints](https://www.infobip.com/docs/metrics-api/querying-data#constraints)\n- [Examples](https://www.infobip.com/docs/metrics-api/examples)\n "
items:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.MetricType'
minItems: 1
uniqueItems: true
required:
- aggregateBy
- filterBy
- metrics
title: AggregateDataRequest
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateBodyType:
type: string
enum:
- TEXT
- CAROUSEL
title: MessagesApiTemplateBodyType
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.TenDlcAiReviewRequest:
type: object
allOf:
- $ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignInfoReviewRequest'
- type: object
properties:
optInMessage:
type: string
description: The message sent to the user after they have subscribed.
helpMessage:
type: string
description: The message sent to a user after they have asked for help.
optOutMessage:
type: string
description: The message sent to a user after they have asked to stop receiving messages.
ctaWebsite:
type: string
description: CTA website URL
ctas:
type: array
description: List of call-to-action texts
items:
type: string
description: List of call-to-action texts
useCases:
type: array
description: The use cases for this campaign.
items:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.TenDlcUseCase'
ageGated:
type: boolean
description: Whether the campaign is age-gated (18+)
directLending:
type: boolean
description: Whether the campaign involves direct lending
messageFlow:
type: string
description: Message flow description
description: Request to submit 10DLC campaign info for AI compliance review with full details
required:
- ageGated
- brandName
- brandSupportEmail
- brandWebsite
- ctaWebsite
- ctas
- customerCareEmail
- directLending
- helpMessage
- messageExamples
- messageFlow
- optInMessage
- optOutMessage
- programDescription
- reviewType
- useCases
title: TenDlcAiReviewRequest
99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.BillingUsageMetadata:
type: object
description: Additional billing data metadata included in the response.
properties:
clientRequestedPeriod:
allOf:
- $ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.clientRequestedPeriod'
description: Originally requested time period referenced in the response.
billingPeriods:
type: array
description: Metadata for each covered calendar month.
items:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.BillingUsageMetadataPeriod'
required:
- billingPeriods
- clientRequestedPeriod
title: BillingUsageMetadata
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.DeliveryDay:
type: string
description: Days of the week which are included in the delivery time window. At least one day must be provided. Separate multiple days with a comma.
enum:
- MONDAY
- TUESDAY
- WEDNESDAY
- THURSDAY
- FRIDAY
- SATURDAY
- SUNDAY
title: DeliveryDay
2be764ef53499e28cc8da8dff3890f0787860aba10984e520352c73612c0342b.Entity:
type: object
properties:
entityName:
type: string
description: Descriptive name of the resource.
example: Test name
maxLength: 255
entityId:
type: string
description: The unique identifier of the entity. This ID will be a URL path parameter. We recommend using values that do not need URL encoding for easier interaction with other API endpoints.
example: test-entity
maxLength: 255
required:
- entityId
title: Entity
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.MmsNoIdSubscriptionRequest:
type: object
description: Subscription group.
properties:
name:
type: string
description: Subscription group name.
maxLength: 255
minLength: 1
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyProfileRequest'
events:
type: array
description: List of events available for subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](/docs/cpaas-x/subscriptions-management#availability). In case you are configuring inbound Subscription please check all the details [available here](/docs/cpaas-x/subscriptions-management#inbound-message-configuration).
items:
oneOf:
- $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleMmsEvents'
- $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.FormatAwareMmsEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
required:
- events
- profile
title: MMS
bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.GetApiKeysResponse:
type: object
properties:
apiKeys:
type: array
description: List of API keys.
items:
$ref: '#/components/schemas/bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.ApiKey'
paging:
$ref: '#/components/schemas/bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.PagingResponse'
required:
- paging
title: GetApiKeysResponse
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.NumberPreview:
type: object
properties:
numberKey:
type: string
description: Unique ID of the number.
number:
type: string
description: Number.
countryCode:
type: string
description: Number's country code.
title: NumberPreview
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiChannelsDestination:
type: object
description: Represents a destination which can be specified by a `channel`. **It is required for a message failover**.
properties:
messageId:
type: string
description: The ID that uniquely identifies the message sent. If failover is defined, then it will override values provided in `byChannel` array and be applied to each message in failover flow.
maxLength: 200
minLength: 0
byChannel:
type: array
description: An array of substitute destinations, each associated with a specific `channel`. Only one substitute destination is allowed per `channel`. A substitute destination must be provided for the main `channel` defined in the `message`.
items:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiChannelDestination'
required:
- byChannel
title: Channels Destination
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.VettingProvider:
type: string
description: Provider for imported brand vet.
enum:
- AEGIS_MOBILE
- CAMPAIGN_VERIFY
- WMC_GLOBAL
title: VettingProvider
aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6e.StartAuthenticationResponse:
type: object
properties:
callStatus:
type: string
description: Call status, e.g. `PENDING_ACCEPTED`.
readOnly: false
writeOnly: false
externalMessageId:
type: string
description: Message ID used for delivery tracking.
readOnly: false
writeOnly: false
ncStatus:
type: string
description: 'Status of sent [Number Lookup](https://www.infobip.com/docs/number-lookup). Number Lookup status can have one of the following values: `NC_DESTINATION_UNKNOWN`, `NC_DESTINATION_REACHABLE`, `NC_DESTINATION_NOT_REACHABLE`, `NC_NOT_CONFIGURED`. Contact your Account Manager, if you get the `NC_NOT_CONFIGURED` status. SMS will not be sent only if Number Lookup status is `NC_NOT_REACHABLE`.'
readOnly: false
writeOnly: false
pinId:
type: string
description: Sent PIN code ID.
readOnly: false
writeOnly: false
smsStatus:
type: string
description: 'Sent SMS status. Can have one of the following values: `MESSAGE_SENT`, `MESSAGE_NOT_SENT`.'
readOnly: false
writeOnly: false
to:
type: string
description: 'Phone number to which the 2FA message will be sent. Example: `41793026727`.'
readOnly: false
writeOnly: false
title: StartAuthenticationResponse
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignBuilderCampaignAttributes:
type: string
description: Campaign attributes that indicate special content characteristics
enum:
- AGE_GATED
- DIRECT_LENDING
title: CampaignBuilderCampaignAttributes
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.RejectionReasonPayload:
type: object
description: The rejection reasons details. This field is present only when new campaign registration status is 'REJECTED'.
properties:
errorCode:
type: string
description: Predefined code.
example: '1001'
description:
type: string
description: Rejection reason.
example: Campaign appears to be for an age gated content type but age gate attribute is not selected.
title: RejectionReasonPayload
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignFeedback:
type: object
description: Offers additional information regarding the campaign, includes rejection reason and time.
properties:
rejectionReasons:
type: array
description: The reasons for the rejection.
items:
type: string
description: The reasons for the rejection.
rejectionDetails:
type: array
description: Rejection reasons details.
items:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.RejectionReason'
rejectionDate:
type: string
format: date-time
description: The time of the rejection.
readOnly: true
title: CampaignFeedback
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.IbResourceInfo:
type: object
description: Resource basic info.
oneOf:
- $ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.NumberResourceInfo'
- $ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.AlphaResourceInfo'
- $ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.RcsResourceInfo'
- $ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.ViberResourceInfo'
- $ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.AppleResourceInfo'
- $ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.OpenChannelResourceInfo'
title: IbResourceInfo
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.SendingSpeedLimit:
type: object
description: Limits the send speed when sending messages in bulk to deliver messages over a longer period of time. You may wish to use this to allow your systems or agents to handle large amounts of incoming traffic, e.g., if you are expecting recipients to follow through with a call-to-action option from a message you sent. Not setting a send speed limit can overwhelm your resources with incoming traffic.
properties:
amount:
type: integer
format: int32
description: The number of messages to be sent per timeUnit. By default, the system sends messages as fast as the infrastructure allows. Use this parameter to adapt sending capacity to your needs. The system is only able to work against its maximum capacity for ambitious message batches.
timeUnit:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.SpeedLimitTimeUnit'
required:
- amount
title: SendingSpeedLimit
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessage:
type: object
description: Represents a single message.
properties:
channel:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.OutboundMessageChannel'
sender:
type: string
description: The sender ID. It can be alphanumeric or numeric (e.g., `CompanyName`). Make sure you don't exceed [character limit](https://www.infobip.com/docs/sms/get-started#sender-names).
destinations:
type: array
description: Array of destination objects for where messages are being sent. A valid destination is required. **`Channels Destination` is required when sending messages with defined failover.**
items:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessageDestination'
content:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageContent'
options:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageOptions'
webhooks:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiWebhooks'
failover:
type: array
description: Provides options for configuring a message failover. When message fails it will be sent over channels in order specified in an array. It has to contain unique entries per channel and it cannot contain entry with the same channel as original message. **Make sure to provide correct sender and destinations specified as `Channels Destination` for each channel**.
items:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiBaseFailover'
required:
- channel
- content
- destinations
title: Messages API message
e35a706fc99c4749296ef942f9e5af764730e23804a8d85886e3d0a3e3fc2340.ApiException:
type: object
properties:
requestError:
$ref: '#/components/schemas/ApiRequestError'
title: ApiException
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.SeenStatusReporting:
type: object
description: Provides options for configuring the seen report behavior.
properties:
url:
type: string
description: The URL on your call back server where a seen report will be sent.
title: SeenStatusReporting
e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.CatalogFieldDataType:
type: string
description: 'Field data type. Note: Once created, you cannot change the data type.'
enum:
- TEXT
- INTEGER
- DECIMAL
- DATE
- TIME
- DATE_TIME
- BOOLEAN
title: CatalogFieldDataType
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiInboundEventType:
type: string
description: Event type.
enum:
- MO
- TYPING_STARTED
- TYPING_STOPPED
title: MessagesApiInboundEventType
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MoAction:
type: object
description: Forward action configuration.
discriminator:
propertyName: type
mapping:
HTTP_FORWARD: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.HttpForwardAction'
MAIL_FORWARD: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MailForwardAction'
SMPP_FORWARD: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.SmppForwardAction'
PULL: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.PullAction'
FORWARD_TO_EXTERNAL_INTEGRATION: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.ForwardToExternalIntegrationAction'
NO_ACTION: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.NoAction'
properties:
type:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MoActionType'
description:
type: string
description: Additional action description.
example: My description.
title: MoAction
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.MobileIdentitySubscriptionRequest:
type: object
description: Subscription group.
properties:
subscriptionId:
type: string
description: Subscription ID. Used as part of a URL path and must not include any characters that require URL encoding. You cannot change the ID once a subscription is created.
maxLength: 255
minLength: 1
name:
type: string
description: A human-readable description for your subscription, can be changed at a later point.
maxLength: 255
minLength: 1
events:
type: array
description: List of events available for a subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](https://www.infobip.com/docs/cpaas-x/subscriptions-management/event-subscriptions). If configuring inbound Subscription, check [inbound message configuration docs](https://www.infobip.com/docs/cpaas-x/subscriptions-management/inbound-message-configuration).
items:
oneOf:
- $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleMobileIdentityEvents'
- $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.FormatAwareMobileIdentityEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfileRequest'
required:
- events
- profile
- subscriptionId
title: Mobile Identity
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.FormatAwareEvent:
type: object
properties:
format:
type: string
event:
type: string
required:
- event
- format
title: Event with format
4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611.Status:
type: string
description: Current bulk status.
enum:
- PENDING
- PAUSED
- PROCESSING
- CANCELED
- FINISHED
- FAILED
example: PENDING
title: Status
99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.AggregateDataFilter:
type: object
description: "\nA JSON object specifying the criteria to filter the results. Each field in the object represents a different filter\ncriterion, enabling detailed and complex filtering.\n "
properties:
accountKeys:
type: array
description: "\nSpecifies a list of unique account keys (identifiers).\n\nIf not provided, the metrics data for the requester's account will be used by default.\n\nExample:\n\n```\n\"accountKeys\": [\"account_key_1\", \"account_key_2\"]\n```\n\nTo retrieve all available account keys, refer to the\n[Account list endpoint](https://www.infobip.com/docs/api/platform/account-management/get-all-accounts).\n "
items:
type: string
description: "\nSpecifies a list of unique account keys (identifiers).\n\nIf not provided, the metrics data for the requester's account will be used by default.\n\nExample:\n\n```\n\"accountKeys\": [\"account_key_1\", \"account_key_2\"]\n```\n\nTo retrieve all available account keys, refer to the\n[Account list endpoint](https://www.infobip.com/docs/api/platform/account-management/get-all-accounts).\n "
uniqueItems: true
includeSubaccounts:
type: boolean
default: false
description: "\nDetermines whether to include traffic data from sub-accounts (children accounts) along with the specified accounts in\n `accountKeys`.\n\nIf set to true, the traffic data for the specified accounts and their sub-accounts is aggregated.\n\nIf set to false, only the traffic data for the specified accounts in `accountKeys` is considered.\n\nThis parameter is optional. If not provided, it defaults to false.\n\nExample:\n\n```\n\"includeSubaccounts\": true\n```\n "
example: true
sentSince:
type: string
format: date-time
description: "\nThe start date-time for filtering sent traffic (inclusive).\n\nHas the following format: `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.\n "
sentUntil:
type: string
format: date-time
description: "\nThe end date-time for filtering sent traffic (exclusive).\n\nHas the following format: `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.\n "
timeToDeliver:
type: array
description: "\nRepresents the time within which a message is delivered using time buckets.\n\nFor example, you can filter only for messages delivered within a second. The `from` bucket is inclusive, while the `to` bucket is exclusive.\n "
items:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.TimeSpan'
uniqueItems: true
timeToAnswer:
type: array
description: "\nRepresents the time it took for the call to be answered using time buckets.\n\nFor example, you can filter only for calls answered within a second. The `from` bucket is inclusive, while the `to` bucket is exclusive.\n "
items:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.TimeSpan'
uniqueItems: true
timeToClickFromSeen:
type: array
description: "\nRepresents the time within which a URL is clicked after the message is seen using time buckets.\n\nFor example, you can filter only messages whose URLs were clicked within 1 second after they were seen. The `from`\nbucket is inclusive, while the `to` bucket is exclusive.\n "
items:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.TimeSpan'
uniqueItems: true
timeToClickFromDelivered:
type: array
description: "\nRepresents the time within which a URL is clicked after the message is delivered using time buckets.\n\nFor example, you can filter only for messages whose URLs were clicked within 1 second after delivery. The `from` bucket\n is inclusive, while the `to` bucket is exclusive.\n "
items:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.TimeSpan'
uniqueItems: true
timeToSeenFromDelivered:
type: array
description: "\nRepresents the time within which a message is seen after the message is delivered using time buckets.\n\nFor example, you can filter only for messages seen within 1 second after they were delivered. The `from` bucket is\ninclusive, while the `to` bucket is exclusive.\n "
items:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.TimeSpan'
uniqueItems: true
timeToOpenFromDelivered:
type: array
description: "\nRepresents the time within which a message is opened after the message is delivered using time buckets.\n\nFor example, you can filter only for messages opened within 1 second after they were delivered. The `from` bucket is inclusive, while the `to` bucket is exclusive.\n "
items:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.TimeSpan'
uniqueItems: true
channelCodes:
type: array
description: '
Specifies communication channels and/or services. This is a list of available channels/services and their codes:
* `SMS` - SMS
* `EMAIL` - Email
* `FACEBOOK` - Facebook Messenger
* `INSTAGRAM` - Instagram Messaging
* `KAKAO` - Kakao
* `LINE` - Line
* `MMS` - MMS
* `RCS` - RCS
* `TELEGRAM` - Telegram
* `VIBER` - Viber
* `VOICE_VIDEO` - Voice and Video
* `WHATSAPP` - WhatsApp
* `ZALO` - Zalo
* `APPLE_MB` - Apple Messages for Business
'
items:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.ChannelCode'
minLength: 1
uniqueItems: true
capabilities:
type: array
description: "\nSpecifies the function, technology, or flavor within the selected channelCodes, making it easier to identify similar\nservices across channels or services.\n\nAvailable capabilities and their codes:\n\n* `PHONE` – Phone\n* `WEBRTC` – WebRTC\n* `SIPTRUNK` – SIP Trunks\n* `VIBER_BC` – Viber Business Calls\n* `WHATSAPP_BC` – WhatsApp Business Calls\n* `LINE_OA` – LINE Official Account\n* `LINE_ON` – LINE Official Notifications\n* `KAKAO_A` – Kakao Alim\n* `KAKAO_B` – Kakao Brand Message\n* `KAKAO_S` – Kakao Sangdam\n* `ZALO_NS` – Zalo Notification Services\n* `ZALO_F` – Zalo Follower\n* `VIBER_BM` – Viber Business Messages\n* `VIBER_BOTS` – Viber Bots\n* `MESSENGER` – Messenger\n* `INSTAGRAM_DM` – Instagram Direct Messaging\n "
items:
type: string
description: "\nSpecifies the function, technology, or flavor within the selected channelCodes, making it easier to identify similar\nservices across channels or services.\n\nAvailable capabilities and their codes:\n\n* `PHONE` – Phone\n* `WEBRTC` – WebRTC\n* `SIPTRUNK` – SIP Trunks\n* `VIBER_BC` – Viber Business Calls\n* `WHATSAPP_BC` – WhatsApp Business Calls\n* `LINE_OA` – LINE Official Account\n* `LINE_ON` – LINE Official Notifications\n* `KAKAO_A` – Kakao Alim\n* `KAKAO_B` – Kakao Brand Message\n* `KAKAO_S` – Kakao Sangdam\n* `ZALO_NS` – Zalo Notification Services\n* `ZALO_F` – Zalo Follower\n* `VIBER_BM` – Viber Business Messages\n* `VIBER_BOTS` – Viber Bots\n* `MESSENGER` – Messenger\n* `INSTAGRAM_DM` – Instagram Direct Messaging\n "
uniqueItems: true
directions:
type: array
description: "\nSpecifies the direction of traffic, indicating whether the message was sent to the user (OUTBOUND) or received from the user (INBOUND).\n "
items:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.Direction'
uniqueItems: true
trafficTypes:
type: array
description: "\nSpecifies the types of traffic. For a full list of values, refer to\n[traffic types](https://www.infobip.com/docs/metrics-api/metrics-and-filters#traffictypes).\n "
items:
type: string
description: "\nSpecifies the types of traffic. For a full list of values, refer to\n[traffic types](https://www.infobip.com/docs/metrics-api/metrics-and-filters#traffictypes).\n "
uniqueItems: true
senders:
type: array
description: "\nSpecifies the sender IDs, which can be alphanumeric or numeric.\n\nExample:\n\n```\n\"senders\": [\"mySender\", \"12345\", \"15551234567\", \"jane.smith@somecompany.com\"]\n```\n "
items:
type: string
description: "\nSpecifies the sender IDs, which can be alphanumeric or numeric.\n\nExample:\n\n```\n\"senders\": [\"mySender\", \"12345\", \"15551234567\", \"jane.smith@somecompany.com\"]\n```\n "
uniqueItems: true
senderTypes:
type: array
description: "\nSpecifies the types of senders. For a full list of values, refer to\n[sender types](https://www.infobip.com/docs/metrics-api/metrics-and-filters#sendertypes).\n\nExample:\n\n```\n\"senderTypes\": [\"ALPHANUMERIC\", \"SHORT_CODE\", \"VIRTUAL_LONG_NUMBER\", \"DOMAIN\"]\n```\n "
items:
type: string
description: "\nSpecifies the types of senders. For a full list of values, refer to\n[sender types](https://www.infobip.com/docs/metrics-api/metrics-and-filters#sendertypes).\n\nExample:\n\n```\n\"senderTypes\": [\"ALPHANUMERIC\", \"SHORT_CODE\", \"VIRTUAL_LONG_NUMBER\", \"DOMAIN\"]\n```\n "
uniqueItems: true
communicationIds:
type: array
description: "\nSpecifies the list of communication IDs associated with either a Broadcast or a Moments/Flow campaign.\n\nUse communication IDs to filter data related to specific campaigns.\n\nFor detailed information on the differences between Broadcast and Flow campaigns, refer to the\n[Broadcast](https://www.infobip.com/docs/broadcast) and [Flow overview](https://www.infobip.com/docs/moments).\n\nExample:\n\n```\n\"communicationIds\": [12354646546, 45534466546, 754564654689]\n```\n "
items:
type: integer
format: int64
description: "\nSpecifies the list of communication IDs associated with either a Broadcast or a Moments/Flow campaign.\n\nUse communication IDs to filter data related to specific campaigns.\n\nFor detailed information on the differences between Broadcast and Flow campaigns, refer to the\n[Broadcast](https://www.infobip.com/docs/broadcast) and [Flow overview](https://www.infobip.com/docs/moments).\n\nExample:\n\n```\n\"communicationIds\": [12354646546, 45534466546, 754564654689]\n```\n "
uniqueItems: true
campaignReferenceIds:
type: array
description: "\nSpecifies the list of campaign reference IDs used for traffic sent over Infobip APIs.\n\nUse `campaignReferenceIDs` to filter data related to specific campaigns.\n "
items:
type: string
description: "\nSpecifies the list of campaign reference IDs used for traffic sent over Infobip APIs.\n\nUse `campaignReferenceIDs` to filter data related to specific campaigns.\n "
uniqueItems: true
networkIds:
type: array
description: "\nList of network IDs.\n "
items:
type: integer
format: int32
description: "\nList of network IDs.\n "
uniqueItems: true
countryIds:
type: array
description: "\nList of country IDs.\n "
items:
type: integer
format: int32
description: "\nList of country IDs.\n "
uniqueItems: true
platforms:
type: array
description: "\nSpecifies the platform object, which is a combination of an applicationId and entityId. These IDs uniquely identify each application and entity configured on the Infobip platform.\n\nUse this object and its related parameters to filter data for a specific application and entity combination. Note that these parameters should only be used if you leverage CPaaS X applications and entities to manage your traffic.\n\nFor detailed information on applications and entities in the CPaaS X ecosystem, refer to the\n[CPaaSX overview](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).\n "
items:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.Platform'
uniqueItems: true
applicationId:
type: string
deprecated: true
description: "\nA unique identifier assigned to an application, use case, or environment within the Infobip CPaaS X ecosystem.\n\nUse this parameter to filter data for a specific application.\n\nTo retrieve all available application IDs, refer to the\n[Application list endpoint](https://www.infobip.com/docs/api/platform/application-entity/get-applications).\n\nExample:\n\n```\n\"applicationId\": \"your_application_id\"\n```\n "
entityId:
type: string
deprecated: true
description: "\nA unique identifier assigned to an entity, such as a brand, customer, or other defined component, within the Infobip CPaaS X ecosystem.\n\nUse this parameter to filter data for a specific entity.\n\nTo retrieve all available entity IDs, refer to the\n[Entity list endpoint](https://www.infobip.com/docs/api/platform/application-entity/get-entities).\n\nExample:\n\n```\n\"entityId\": \"your_entity_id\"\n```\n "
statusGroups:
type: array
description: "\nSpecifies the general status code groups.\n\nFor the list of possible values, refer to\n[general status codes](https://www.infobip.com/docs/essentials/response-status-and-error-codes#general-error-codes).\n "
items:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.GeneralStatus'
uniqueItems: true
statuses:
type: array
description: "\nSpecifies the message status reason.\n\nFor the list of possible values, refer to\n[message status reasons](https://www.infobip.com/docs/essentials/response-status-and-error-codes).\n "
items:
type: string
description: "\nSpecifies the message status reason.\n\nFor the list of possible values, refer to\n[message status reasons](https://www.infobip.com/docs/essentials/response-status-and-error-codes).\n "
uniqueItems: true
errorGroups:
type: array
description: "\nSpecifies the general error code groups.\n\nFor the list of possible values, refer to\n[error codes groups](https://www.infobip.com/docs/essentials/response-status-and-error-codes#general-error-codes).\n "
items:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.ErrorCodeGroup'
uniqueItems: true
errorCodes:
type: array
description: "\nSpecifies the error codes.\n\nFor the list of possible values, refer to\n[error codes](https://www.infobip.com/docs/essentials/response-status-and-error-codes#general-error-codes).\n "
items:
type: string
description: "\nSpecifies the error codes.\n\nFor the list of possible values, refer to\n[error codes](https://www.infobip.com/docs/essentials/response-status-and-error-codes#general-error-codes).\n "
uniqueItems: true
required:
- channelCodes
- sentSince
- sentUntil
title: AggregateDataFilter
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.FormatAwareBlocklistEvents:
type: object
properties:
event:
type: string
enum:
- BLOCK
- UNBLOCK
format:
type: string
description: Format which you want to assign to the event. For more information about available formats and their payload, check our [Event Formats](https://www.infobip.com/docs/cpaas-x/subscriptions-management/event-formats) page.
required:
- event
- format
title: Event with format
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.UrlOptions:
type: object
description: 'Sets up [URL shortening](https://www.infobip.com/docs/url-shortening) and tracking feature. Does not apply to channels that do not support it: Instagram, LINE, Messenger, Viber Bot.'
properties:
shortenUrl:
type: boolean
default: true
description: Enable shortening of the URLs within a message. Set this to `true`, if you want to set up other URL options.
trackClicks:
type: boolean
default: true
description: 'Enable tracking of short URL clicks within a message: which URL was clicked, how many times, and by whom.'
trackingUrl:
type: string
description: The URL of your callback server on to which the Click report will be sent.
removeProtocol:
type: boolean
default: false
description: Remove a protocol, such as `https://`, from links to shorten a message. Note that some mobiles may not recognize such links as a URL.
customDomain:
type: string
description: Select a predefined custom domain to use when generating a short URL.
title: UrlOptions
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.Webhook:
type: object
description: Webhook configuration.
properties:
contentType:
type: string
maxLength: 255
minLength: 0
notifyUrl:
type: string
description: Your webhook URL, where the notifications will be sent to.
maxLength: 512
minLength: 0
required:
- notifyUrl
title: Webhook
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyProfileResponse:
type: object
description: Notification profile.
properties:
profileId:
type: string
description: Unique profile ID.
security:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlySecurityResponse'
title: Profile
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandRegistrationWebhookContent:
type: object
description: Event content.
properties:
brandId:
type: string
format: uuid
description: The ID of the brand.
example: 0579c038-55f2-11ee-9458-325096b39f47
brandStatus:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.WebhookBrandRegistrationStatus'
rejectionReasons:
type: array
description: The rejection reasons. This field is present only when brand registration status is 'FAILURE'.
example:
- Tax id does not match with the company name or business type.
items:
type: string
description: The rejection reasons. This field is present only when brand registration status is 'FAILURE'.
example: '["Tax id does not match with the company name or business type."]'
title: BrandRegistrationWebhookContent
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.Channel:
type: string
enum:
- APPLE_MB
- INSTAGRAM_DM
- LINE_ON
- MESSENGER
- MMS
- RCS
- SMS
- VIBER_BM
- VIBER_BOT
- WHATSAPP
title: Channel
99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.Platform:
type: object
description: "\nSpecifies the platform object, which is a combination of an applicationId and entityId. These IDs uniquely identify each application and entity configured on the Infobip platform.\n\nUse this object and its related parameters to filter data for a specific application and entity combination. Note that these parameters should only be used if you leverage CPaaS X applications and entities to manage your traffic.\n\nFor detailed information on applications and entities in the CPaaS X ecosystem, refer to the\n[CPaaSX overview](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).\n "
properties:
applicationId:
type: string
description: "\nA unique identifier assigned to an application, use case, or environment within the Infobip CPaaS X ecosystem.\n\nUse this parameter to filter data for a specific application.\n\nTo retrieve all available application IDs, refer to the\n[Application list endpoint](https://www.infobip.com/docs/api/platform/application-entity/get-applications).\n "
example: your_application_id
entityId:
type: string
description: "\nA unique identifier assigned to an entity, such as a brand, customer, or other defined component, within the Infobip CPaaS X ecosystem.\n\nUse this parameter to filter data for a specific entity.\n\nTo retrieve all available entity IDs, refer to the\n[Entity list endpoint](https://www.infobip.com/docs/api/platform/application-entity/get-entities).\n "
example: your_entity_id
title: Platform
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.FormatAwareMmsEvents:
type: object
properties:
event:
type: string
enum:
- CLICK
- DELIVERY
- INBOUND_MESSAGE
format:
type: string
description: Format which you want to assign to the event. For more information about available formats and their payload, check our [Event Formats](https://www.infobip.com/docs/cpaas-x/subscriptions-management/event-formats) page.
required:
- event
- format
title: Event with format
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.NumberRequirementSpecsRequestApiDoc:
type: object
properties:
type:
type: string
description: Type of resource.
enum:
- NUMBER_PURCHASE
quantity:
type: integer
format: int32
description: Amount of numbers. Default value is 1.
maximum: 49
minimum: 1
numberType:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.ResourceNumberType'
capabilities:
type: array
description: Capabilities of the numbers.
items:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.ResourceNumberCapability'
clientType:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.NumberOfferClientType'
countryCode:
type: string
description: Country code in two-letter ISO standard.
required:
- capabilities
- countryCode
- numberType
- type
title: NUMBER_PURCHASE
2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.BlocklistCreate:
type: object
description: Blocklist.
properties:
destinations:
type: array
description: Destination addresses that need to be blocklisted.
items:
$ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.ToCreate'
sender:
type: string
description: The sender ID for which blocklist happened.
maxLength: 255
minLength: 1
channel:
$ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.CreatableChannel'
accountKey:
type: string
description: Account connected with a blocklist record. Main account has access to blocklist records of their subaccounts. Subaccounts can only access blocklist records specific to them. [API to retrieve account key](https://www.infobip.com/docs/api/platform/account-management/get-all-accounts).
required:
- destinations
title: BlocklistCreate
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.WebhookBrandRegistrationStatus:
type: string
description: The new brand registration status.
enum:
- SUCCESS
- FAILURE
- PENDING
- PENDING_2FA
example: FAILURE
title: WebhookBrandRegistrationStatus
2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.BlocklistDeleteRequest:
type: object
description: Blocklist request.
properties:
blocklist:
type: array
description: Blocklist elements that need to be removed from blocklist. Number of destinations cannot exceed 50 000.
items:
$ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.BlocklistDelete'
required:
- blocklist
title: BlocklistDeleteRequest
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiFailover:
type: object
description: Configuration of a single failover step
properties:
channel:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.OutboundMessageChannel'
sender:
type: string
description: Sender for channel specified above.
content:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageContent'
validityPeriod:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.ValidityPeriod'
required:
- channel
title: Message failover
2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.InboundMessageReference:
type: object
description: Inbound message reference, if matched by the Infobip platform.
properties:
inboundMessageId:
type: string
description: ID of the message that triggered the event if matched by the Infobip platform. For example, MO message ID.
title: InboundMessageReference
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageSenderDisplayInfo:
type: object
description: Sender display info (name and avatar). Used only for Viber Bot messages.
properties:
name:
type: string
description: The sender's name to display.
maxLength: 28
minLength: 0
avatarUrl:
type: string
description: The sender's avatar URL.
title: MessagesApiMessageSenderDisplayInfo
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageHeaderType:
type: string
enum:
- TEXT
title: MessagesApiMessageHeaderType
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.AlphaResourceInfo:
type: object
description: Information about alphanumeric type of resource.
properties:
senderName:
type: string
description: Alphanumeric sender name.
example: MySender
countryCode:
type: string
description: Country code in two-letter ISO standard. Required for identifying country specific resources (for instance, short code number types).
example: GB
pattern: ^[A-Z]{2}$
countryName:
type: string
description: Country name.
example: United Kingdom
capabilities:
type: array
description: Capabilities of the sender.
items:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.ResourceCapabilityChannel'
uniqueItems: true
resourceType:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.IbResourceType'
title: Alphanumeric
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.PageResponseCampaign:
type: object
properties:
results:
type: array
description: The list of the results for this page.
items:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.Campaign'
paging:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.PageInfo'
title: PageResponseCampaign
6ac22f6f3346b6db1d4c8464d58b1329c30df516bb4206699a93fd8658df38c7.ErrorResponse:
type: object
description: Error response object.
properties:
errorDetails:
type: string
description: Details of the error, if the request fails.
title: ErrorResponse
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.UseConversations:
type: object
description: Used for forwarding messages to Conversations service.
externalDocs:
description: Find out more about Conversations
url: https://www.infobip.com/docs/conversations
properties:
enabled:
type: boolean
description: Flag which indicates if this action should be enabled. If set to false, the effect will be the same as adding the conversations to unset which will remove the object.
example: true
required:
- enabled
title: UseConversations
5929f45c31f06c29ab1bc6e26caa01575484225e5ef99a2512bee829b646f1c1.PageInfo:
type: object
description: Contains information about the page.
properties:
page:
type: integer
format: int32
description: Requested page number.
minimum: 0
size:
type: integer
format: int32
description: Requested page size.
minimum: 1
totalPages:
type: integer
format: int32
description: The total number of pages of the results matching the requested parameters.
minimum: 0
totalResults:
type: integer
format: int64
description: The total number of the results matching the requested parameters.
minimum: 0
required:
- page
- size
- totalPages
- totalResults
title: PageInfo
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.TollFreeCampaignBuilderResultData:
type: object
allOf:
- $ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignBuilderResultData'
- type: object
properties:
useCase:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.TollFreeUseCase'
messageFlow:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.TollFreeCampaignBuilderResultMessageFlow'
channelNote:
type: string
description: Channel-specific note.
termsConditions:
type: string
writeOnly: true
privacyPolicy:
type: string
writeOnly: true
description: Campaign builder result for Toll Free Number campaigns.
title: TollFreeCampaignBuilderResultData
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.ExternalAutomaticReviewResults:
type: object
properties:
reviewStatus:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.ExternalAutomaticReviewStatus'
campaignErrors:
type: array
description: List of compliance errors found during the AI campaign review. Empty when the review is still processing or the campaign is compliant.
items:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.ExternalAutomaticReviewError'
title: ExternalAutomaticReviewResults
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandRegistrationStatusPublic:
type: string
description: The state of the registration for this brand.
enum:
- ACTIVE
- PENDING
- PENDING_2FA
- PENDING_APPEAL
- REJECTED
example: REJECTED
title: BrandRegistrationStatusPublic
aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6e.StartAuthenticationRequest:
type: object
properties:
applicationId:
type: string
description: The ID of the application that represents your service, e.g. 2FA for login, 2FA for changing the password, etc.
readOnly: false
writeOnly: true
from:
type: string
description: Use this parameter if you wish to override the sender ID from the [created](#channels/sms/create-2fa-message-template) message template parameter `senderId`.
readOnly: false
writeOnly: false
messageId:
type: string
description: The ID of the message template (message body with the PIN placeholder) that is sent to the recipient.
readOnly: false
writeOnly: true
placeholders:
type: object
additionalProperties:
type: string
description: 'Key value pairs that will be replaced during message sending. Placeholder keys should NOT contain curly brackets and should NOT contain a `pin` placeholder. Valid example: `"placeholders":{"firstName":"John"}`'
readOnly: false
writeOnly: true
to:
type: string
description: 'Phone number to which the 2FA message will be sent. Example: 41793026727.'
readOnly: false
writeOnly: true
trackDelivery:
type: boolean
default: false
description: 'Enables sending of delivery reports via [Subscriptions](https://www.infobip.com/docs/cpaas-x/subscriptions-management). The [retry cycle](https://www.infobip.com/docs/sms/sms-over-api#push-retry-cycle-notify-url) for when your URL becomes unavailable uses the following formula: `1min + (1min * retryNumber * retryNumber)`.'
readOnly: false
writeOnly: true
required:
- applicationId
- messageId
- to
title: StartAuthenticationRequest
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignBuilderOptInMethod:
type: string
description: Method used to obtain consumer opt-in consent for messaging
enum:
- VERBAL
- ONLINE
- KEYWORD
- IVR
title: CampaignBuilderOptInMethod
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.ResourceOrderIdentifier:
type: object
properties:
id:
type: string
format: uuid
description: The ID of the resource request.
title: ResourceOrderIdentifier
5929f45c31f06c29ab1bc6e26caa01575484225e5ef99a2512bee829b646f1c1.SenderType:
type: string
description: Sender type.
enum:
- ALPHANUMERIC
- VIRTUAL_LONG_NUMBER
- SHORT_CODE
- TOLL_FREE_NUMBER
example: ALPHANUMERIC
title: SenderType
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.PageInfo:
type: object
description: Contains information about the page.
properties:
page:
type: integer
format: int32
description: Requested page number.
minimum: 0
size:
type: integer
format: int32
description: Requested page size.
minimum: 1
totalPages:
type: integer
format: int32
description: The total number of pages of the results matching the requested parameters.
minimum: 0
totalResults:
type: integer
format: int64
description: The total number of the results matching the requested parameters.
minimum: 0
required:
- page
- size
- totalPages
- totalResults
title: PageInfo
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiWebhooks:
type: object
description: Provides options for configuring message webhooks.
properties:
delivery:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiDelivery'
contentType:
type: string
description: Preferred delivery report content type, `application/json` or `application/xml`.
callbackData:
type: string
description: Additional data that can be used for identifying, managing, or monitoring a message. Data included here will also be automatically included in the message Delivery Report and Seen Report. The maximum value is 4000 characters.
maxLength: 4000
minLength: 0
seen:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.SeenStatusReporting'
title: MessagesApiWebhooks
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignAiBuilderWebhookResponse:
type: object
properties:
results:
type: array
description: Incoming events
items:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignAiBuilderWebhookMessage'
title: CampaignAiBuilderWebhookResponse
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.DocumentIdentifier:
type: object
properties:
documentId:
type: string
description: The ID of the document.
title: DocumentIdentifier
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleOpenChannelEvents:
type: string
enum:
- DELIVERY
title: Event
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.AlphaResourceOrderApiDoc:
type: object
properties:
id:
type: string
format: uuid
description: The ID of the resource.
type:
type: string
description: Type of resource.
enum:
- ALPHANUMERIC_REGISTRATION
countryCode:
type: string
description: Country code in two-letter ISO standard.
senderName:
type: string
description: Sender name.
requestedByEmailAddress:
type: string
description: Email address of the requester.
additionalContactEmailAddresses:
type: array
description: Additional email addresses.
items:
type: string
description: Additional email addresses.
requestedDate:
type: string
format: date-time
description: Date and time the resource was requested.
status:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.ResourceOrderStatus'
trafficOrigin:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.TrafficOrigin'
trafficType:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.TrafficType'
note:
type: string
description: A note containing extra data about the request.
requirementsFeedback:
type: array
description: List of feedback for requirements.
items:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.FilledRequirementFeedback'
requirements:
type: array
description: List of requirements for the resource.
items:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.FilledRequirement'
platform:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.Platform'
title: ALPHANUMERIC_REGISTRATION
e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.CreateCatalogFieldDto:
type: object
properties:
id:
type: string
description: Field ID.
example: caad56e4-2a1c-4ae8-9717-ebb40d05533d
dataType:
$ref: '#/components/schemas/e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.CatalogFieldDataType'
name:
type: string
description: Field name.
example: Custom name
required:
- dataType
- name
title: CreateCatalogFieldDto
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleFacebookEvents:
type: string
enum:
- CLICK
- CONSENT_UPDATE
- DELIVERY
- INBOUND_MESSAGE
- SEEN
title: Event
bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.Platform:
type: object
description: A collection of CPaaS X Applications and Entities that will be linked to the API key. All Applications and Entities will be removed from the api key if an empty platform list is sent and 'PUBLIC_API' will be assigned as default permission. Or, to remove a specific Application/Entity pair, omit it from the platform list.
externalDocs:
description: 'WARNING: linking an existing API Key to an Application and/or Entity will limit access to these endpoints.'
url: https://www.infobip.com/docs/cpaas-x/application-and-entity-management#api-keys-endpoints-list-api-keys-with-application-and-entity
properties:
key:
type: string
description: Unique identifier of application and/or entity association.
readOnly: true
applicationId:
type: string
description: ID of a CPaaS X Application. Once linked to an Application, the API key can only be used to send messages using linked Applications. Mandatory for every Application and/or Entity pair. Use the default value to reference a default Application. Use an existing Application created using [create-application endpoint](https://www.infobip.com/docs/api/platform/application-entity/create-application) or specify a new applicationId to create a new Application.
entityId:
type: string
description: ID of a CPaaS X Entity. Once linked to an Entity, the API key can only be used to send messages using linked Entities. Use an existing Entity created using [create-entity endpoint](https://www.infobip.com/docs/api/platform/application-entity/create-entity) or specify a new entityId to create a new Entity.
action:
$ref: '#/components/schemas/bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.Action'
required:
- applicationId
title: Platform
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiRequestOptions:
type: object
description: Options applicable to all messages in the request.
properties:
schedule:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.RequestSchedulingSettings'
tracking:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.UrlOptions'
messageOrdering:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessageOrderingOptions'
title: MessagesApiRequestOptions
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.SouthKoreaOptions:
type: object
description: Use case dependent parameters for sending SMS to phone numbers registered in South Korea.
properties:
title:
type: string
description: Title of the message.
maxLength: 66
minLength: 0
resellerCode:
type: integer
format: int32
description: 'Reseller identification code: 9-digit registration number in the business registration certificate for South Korea. Resellers should submit this when sending.'
title: SouthKoreaOptions
aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6e.ResendPinRequest:
type: object
properties:
placeholders:
type: object
additionalProperties:
type: string
description: 'Key value pairs that will be replaced during message sending. Placeholder keys should NOT contain curly brackets and should NOT contain a `pin` placeholder. Valid example: `"placeholders":{"firstName":"John"}`'
readOnly: false
writeOnly: true
trackDelivery:
type: boolean
default: false
description: 'Enables sending of delivery reports via [Subscriptions](https://www.infobip.com/docs/cpaas-x/subscriptions-management). The [retry cycle](https://www.infobip.com/docs/sms/sms-over-api#push-retry-cycle-notify-url) for when your URL becomes unavailable uses the following formula: `1min + (1min * retryNumber * retryNumber)`.'
readOnly: false
writeOnly: true
title: ResendPinRequest
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.ExternalAutomaticReviewStatus:
type: string
description: The current status of the AI campaign review.
enum:
- PROCESSING
- COMPLIANT
- NON_COMPLIANT
title: ExternalAutomaticReviewStatus
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageConfirmationBody:
type: object
description: Body of the confirmation message.
properties:
text:
type: string
description: Text to be sent.
description:
type: string
description: Description to be sent.
imageUrl:
type: string
description: URL of the image.
required:
- text
title: MessagesApiMessageConfirmationBody
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.InteractiveVoiceResponseOptIn:
type: object
description: The type of opt in that requires a user to record a confirmation.
properties:
callToAction:
type: string
description: " The message sent to the user to tell them how to subscribe. Must include:\n • Product description\n • Message frequency disclosure\n • Complete terms and conditions OR link to complete terms and conditions\n • Privacy policy OR link to privacy policy\n • STOP keyword\n • The \"Message and data rates may apply\" disclosure\n"
maxLength: 1024
minLength: 20
required:
- callToAction
title: InteractiveVoiceResponseOptIn
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessageGeneralStatus:
type: string
description: Status group name that describes which category the status code belongs to, i.e., [PENDING](https://www.infobip.com/docs/essentials/response-status-and-error-codes#pending-general-status-codes), [UNDELIVERABLE](https://www.infobip.com/docs/essentials/response-status-and-error-codes#undeliverable-general-status-codes), [DELIVERED](https://www.infobip.com/docs/essentials/response-status-and-error-codes#delivered-general-status-codes), [EXPIRED](https://www.infobip.com/docs/essentials/response-status-and-error-codes#expired-general-status-codes), [REJECTED](https://www.infobip.com/docs/essentials/response-status-and-error-codes#rejected-general-status-codes).
enum:
- ACCEPTED
- PENDING
- UNDELIVERABLE
- DELIVERED
- EXPIRED
- REJECTED
title: MessageGeneralStatus
2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.ViewableChannel:
type: string
description: Channel used for sending for which blocklist happened.
enum:
- SMS
- EMAIL
- VOICE_OUTBOUND_TTS
- NEW_PUSH_NOTIF
- VIBER
- RCS
- WHATSAPP
- APPLE_MB
- MMS
title: ViewableChannel
aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6e.StartEmailAuthenticationResponse:
type: object
properties:
emailStatus:
allOf:
- $ref: '#/components/schemas/aa47d40354ee197e21ffad52d2c543bd4f729e250360a844e476aa80deff7b6e.EmailStatus'
description: Indicates the [status](https://www.infobip.com/docs/essentials/response-status-and-error-codes#api-status-codes) of the message and how to recover from an error should there be any.
readOnly: false
writeOnly: false
pinId:
type: string
description: Sent PIN code ID.
readOnly: false
writeOnly: false
to:
type: string
description: 'Email address to which the 2FA message has been sent. Example: john.smith@example.com.'
readOnly: false
writeOnly: false
title: StartEmailAuthenticationResponse
2be764ef53499e28cc8da8dff3890f0787860aba10984e520352c73612c0342b.PageEntity:
type: object
properties:
results:
type: array
items:
$ref: '#/components/schemas/2be764ef53499e28cc8da8dff3890f0787860aba10984e520352c73612c0342b.Entity'
paging:
$ref: '#/components/schemas/2be764ef53499e28cc8da8dff3890f0787860aba10984e520352c73612c0342b.PageInfo'
title: PageEntity
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.UnsetOption:
type: string
description: Used for unsetting configuration options. 1000 values.
items:
$ref: '#/components/schemas/e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.CreateCatalogValueDto'
required:
- values
title: CreateCatalogItemDto
e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.UpdateCatalogValueDto:
type: object
properties:
fieldId:
type: string
description: Field ID.
example: f5cdcb82-7a5b-4707-b37a-4153da514403
value:
type: string
description: Field value.
example: Custom field value
required:
- fieldId
- value
title: UpdateCatalogValueDto
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair:
type: object
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
properties:
applicationId:
type: string
description: CPaaS X property identifying an application, an use case or an environment on your system. Should only be set if you are using CPaaS X Applications with your traffic.
maxLength: 255
minLength: 0
entityId:
type: string
description: CPaaS X property identifying an unique actor on your system. Should only be set if you are using CPaaS X Applications with your traffic.
maxLength: 255
minLength: 0
callsConfigurationId:
type: string
description: CPaaS X calls configuration identifier. Should only be set if you are using CPaaS X Applications with your traffic.
maxLength: 255
minLength: 0
title: ApplicationEntityPair
2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.ToCreate:
type: object
description: To.
properties:
to:
type: string
description: 'Destination address that needs to be blocklisted. Addresses must be a number in international format (example: `41793026727`), a valid email address (example: `recipient@example.com`) or valid email domain (example: `example.com`).'
maxLength: 255
minLength: 1
required:
- to
title: ToCreate
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateHeader:
type: object
description: Header of a template message.
discriminator:
propertyName: type
mapping:
TEXT: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateTextHeader'
DOCUMENT: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateDocumentHeader'
IMAGE: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateImageHeader'
VIDEO: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateVideoHeader'
LOCATION: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateLocationHeader'
properties:
type:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateHeaderType'
required:
- type
title: MessagesApiTemplateHeader
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.AppleResourceInfo:
type: object
description: Information about Apple type of resource.
properties:
resource:
type: string
description: Resource name.
example: MyResource
displayName:
type: string
description: Display name.
example: MyDisplayName
countryCode:
type: string
description: Country code in two-letter ISO standard. Required for identifying country specific resources (for instance, short code number types).
example: GB
pattern: ^[A-Z]{2}$
countryName:
type: string
description: Country name.
example: United Kingdom
capabilities:
type: array
description: Capabilities of the sender.
items:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.ResourceCapabilityChannel'
uniqueItems: true
resourceType:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.IbResourceType'
title: Apple
99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.MetricType:
type: string
enum:
- TOTAL_TRAFFIC_COUNT
- TOTAL_ACCEPTED_TRAFFIC_COUNT
- TOTAL_SMS_MESSAGES_COUNT
- INTERACTION_COUNT
- UNIQUE_CLICKS_COUNT
- TOTAL_CLICKS_COUNT
- UNIQUE_CLICK_THROUGH_RATE
- DELIVERED_TRAFFIC_COUNT
- FAILED_TRAFFIC_COUNT
- TRAFFIC_DELIVERY_RATE
- TRAFFIC_DELIVERED_IN_5_SEC_RATE
- SEEN_OPENED_TRAFFIC_COUNT
- SEEN_OPENED_TRAFFIC_RATE
- TOTAL_SENT_TRAFFIC_COUNT
- TOTAL_RECEIVED_TRAFFIC_COUNT
- RECEIVED_TO_SENT_TRAFFIC_RATIO
- UNIQUE_URL_CLICK_COUNT
- TOTAL_BOUNCE_COUNT
- TOTAL_BOUNCE_RATE
- TOTAL_SUPPRESSED_COUNT
- SOFT_BOUNCE_COUNT
- SOFT_BOUNCE_RATE
- HARD_BOUNCE_COUNT
- HARD_BOUNCE_RATE
- VIEWED_TOTAL_COUNT
- VIEWED_TOTAL_RATE
- TOTAL_CLICK_RATE
- CLICK_TO_OPEN_RATE
- UNSUBSCRIBED_USER_COUNT
- UNSUBSCRIBED_USER_RATE
- EMAIL_COMPLAINTS_COUNT
- EMAIL_COMPLAINTS_RATE
- TOTAL_CALL_COUNT
- TOTAL_ATTEMPTED_CALL_COUNT
- TOTAL_SEIZED_CALL_COUNT
- TOTAL_ANSWERED_CALL_COUNT
- TOTAL_RECEIVED_CALL_COUNT
- AMD_PROCESSED_CALL_COUNT
- ANSWERED_BY_PERSON_CALL_COUNT
- ANSWERED_BY_VOICE_DETECTION_CALL_COUNT
- NOT_ANSWERED_CALL_COUNT
- BUSY_CALL_COUNT
- CANCELED_CALL_COUNT
- FAILED_CALL_COUNT
- TOTAL_CALL_DURATION
- ANSWER_SEIZURE_RATIO
- ANSWER_RATE
- BUSY_RATE
- HUNG_UP_COUNT
- NORMAL_HUNG_UP_COUNT
- ERROR_HUNG_UP_COUNT
title: MetricType
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.RejectionReason:
type: object
description: Rejection reasons details.
properties:
errorCode:
type: string
description: Predefined code.
description:
type: string
description: Rejection reason.
recommendedAction:
type: string
description: Recommended action.
title: RejectionReason
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.FormatAwareOpenChannelEvents:
type: object
properties:
event:
type: string
enum:
- DELIVERY
format:
type: string
description: Format which you want to assign to the event. For more information about available formats and their payload, check our [Event Formats](https://www.infobip.com/docs/cpaas-x/subscriptions-management/event-formats) page.
required:
- event
- format
title: Event with format
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleKakaoAlimEvents:
type: string
enum:
- DELIVERY
title: Event
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.WebhookCampaignNetworkStatus:
type: string
description: The new campaign registration status for a given network.
enum:
- ACTIVE
example: ACTIVE
title: WebhookCampaignNetworkStatus
bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.ApiKeyResponse:
type: object
properties:
key:
type: string
description: Unique key specifying this api key.
publicApiKey:
type: string
description: Authentication key. Use this value for authentication on API. Keep this in secure storage and don't share it.
accountKey:
type: string
description: Unique identifier for account this API key belongs to.
name:
type: string
description: Name of this API Key.
allowedIPs:
type: array
description: List of allowed IP addresses from which this API key will be used. Authentication will fail from any other IP not specified in this list.
items:
type: string
description: List of allowed IP addresses from which this API key will be used. Authentication will fail from any other IP not specified in this list.
validFrom:
type: string
format: date-time
description: Date from which this API key is/will be valid. Time is in UTC.
validTo:
type: string
format: date-time
description: Date until this API key will be valid. Time is in UTC.
enabled:
type: boolean
description: Is API key enabled.
permissions:
type: array
description: List of permissions this API key has granted.
items:
$ref: '#/components/schemas/bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.Permission'
required:
- name
title: ApiKeyResponse
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.NumberType:
type: string
description: The type of number.
enum:
- VIRTUAL_LONG_NUMBER
- SHORT_CODE
- SIM_HOSTING
- VIRTUAL_SIM_HOSTING
- VIRTUAL_LONG_NUMBER_CALL_TRIGGER
- SHORT_CODE_USSD
- WHATSAPP
- VIBER
- VIBER_VOICE
- FACEBOOK
- RCS
- TELEGRAM
- KAKAO_SANGDAM
- OPEN_CHANNEL
title: NumberType
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.TollFreeCampaignBuilderRequest:
type: object
allOf:
- $ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignBuilderRequest'
description: Request to start building Toll free campaign using AI assistant.
required:
- brandId
- campaignIntent
- campaignType
- contactEmail
- optInMethods
title: TollFreeCampaignBuilderRequest
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.NumberResourceInfo:
type: object
description: Information about the numeric type of resource.
properties:
number:
type: string
description: Phone number.
example: '447860041117'
numberKey:
type: string
description: Number key.
example: 58B3840032C7774BAC840EEEA2C23A44
platform:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.PlatformDocs'
numberType:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.NumberTypeResourceMoDocs'
countryCode:
type: string
description: Country code in two-letter ISO standard. Required for identifying country specific resources (for instance, short code number types).
example: GB
pattern: ^[A-Z]{2}$
countryName:
type: string
description: Country name.
example: United Kingdom
capabilities:
type: array
description: Capabilities of the number.
items:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.ResourceCapabilityChannel'
uniqueItems: true
resourceType:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.IbResourceType'
title: Number
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.DocumentMetadata:
type: object
description: Preview of the screenshot document. This property is read-only and ignored in POST/PUT calls.
properties:
documentId:
type: string
format: uuid
description: Unique identifier for the document.
documentName:
type: string
description: Name of the document file.
contentType:
type: string
description: MIME type of the document content (e.g., application/pdf, image/png).
contentLength:
type: integer
format: int32
description: Size of the document content in bytes.
title: DocumentMetadata
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleRegistrationEvents:
type: string
enum:
- AI_CAMPAIGN_BUILDER
- AI_CAMPAIGN_FEEDBACK
- BRAND_AUTH_UPDATE
- BRAND_STATUS_UPDATE
- BRAND_VET_UPDATE
- CAMPAIGN_NETWORK_STATUS_UPDATE
- CAMPAIGN_STATUS_UPDATE
- RESOURCE_REQUEST_FOC_DATE_CHANGE
- RESOURCE_REQUEST_REMINDER
- RESOURCE_REQUEST_STATUS_UPDATE
title: Event
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.RcsResourceInfo:
type: object
description: Information about RCS type of resource.
properties:
senderName:
type: string
description: Sender name.
example: MySender
countryCode:
type: string
description: Country code in two-letter ISO standard. Required for identifying country specific resources (for instance, short code number types).
example: GB
pattern: ^[A-Z]{2}$
countryName:
type: string
description: Country name.
example: United Kingdom
capabilities:
type: array
description: Capabilities of the sender.
items:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.ResourceCapabilityChannel'
uniqueItems: true
resourceType:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.IbResourceType'
title: RCS
e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.CreateCatalogValueDto:
type: object
description: A list of item field values. Maximum 1000 values.
properties:
fieldName:
type: string
description: Field name.
example: Custom field name
fieldId:
type: string
description: Field ID.
example: 8b00a8c6-5302-4fd0-a0cc-bb090b28ac34
value:
type: string
description: Field value.
example: Custom field value
required:
- value
title: CreateCatalogValueDto
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.WebhookBrandVetStatus:
type: string
description: The new brand vet status.
enum:
- SUCCESS
- FAILURE
example: SUCCESS
title: WebhookBrandVetStatus
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.WebPushSubscriptionRequest:
type: object
description: Subscription group.
properties:
subscriptionId:
type: string
description: Subscription ID. Used as part of a URL path and must not include any characters that require URL encoding. You cannot change the ID once a subscription is created.
maxLength: 255
minLength: 1
name:
type: string
description: A human-readable description for your subscription, can be changed at a later point.
maxLength: 255
minLength: 1
events:
type: array
description: List of events available for a subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](https://www.infobip.com/docs/cpaas-x/subscriptions-management/event-subscriptions). If configuring inbound Subscription, check [inbound message configuration docs](https://www.infobip.com/docs/cpaas-x/subscriptions-management/inbound-message-configuration).
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleWebPushEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfileRequest'
required:
- events
- profile
- subscriptionId
title: Web Push
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.NumberPoolUsageApiPageResponse:
type: object
properties:
results:
type: array
description: The list of the results for this page.
items:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.NumberPoolUsageApiResponse'
paging:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.PageInfo'
title: NumberPoolUsageApiPageResponse
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.TenDlcCampaignBuilderResultData:
type: object
allOf:
- $ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignBuilderResultData'
- type: object
properties:
useCase:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.TenDlcUseCase'
messageFlow:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.TenDlcCampaignBuilderResultMessageFlow'
termsConditions:
type: string
writeOnly: true
privacyPolicy:
type: string
writeOnly: true
description: Campaign builder result for 10DLC campaigns.
title: TenDlcCampaignBuilderResultData
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.InboundSeenChannel:
type: string
description: Messaging channel used for sending an event.
enum:
- RCS
- VIBER_BM
- VIBER_BOT
- WHATSAPP
title: InboundSeenChannel
2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.CreatableChannel:
type: string
description: Channel used for sending for which blocklist happened.
enum:
- SMS
- EMAIL
- VIBER
- RCS
- MMS
- WHATSAPP
title: CreatableChannel
c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.RegionalOptions:
type: object
properties:
indiaDlt:
allOf:
- $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.IndiaDltOptions'
description: Distributed Ledger Technology (DLT) specific parameters required for sending SMS to phone numbers registered in India.
readOnly: false
writeOnly: false
title: RegionalOptions
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateFailover:
type: object
description: Configuration of a single failover step
properties:
channel:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.OutboundTemplateChannel'
sender:
type: string
description: Sender for channel specified above.
template:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplate'
content:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateMessageContent'
validityPeriod:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.ValidityPeriod'
required:
- channel
- template
title: Template message failover
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessageResponseMessageResponseDetails:
type: object
description: An array of message objects of a single message or multiple messages sent under one bulk ID.
properties:
messageId:
type: string
description: Unique message ID. If not provided, it will be auto-generated and returned in the API response.
status:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessageStatus'
destination:
type: string
description: The destination address of the message, i.e., its recipient.
details:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessageResponseDetails'
title: MessageResponseMessageResponseDetails
2be764ef53499e28cc8da8dff3890f0787860aba10984e520352c73612c0342b.PageResourceAssociation:
type: object
properties:
results:
type: array
items:
$ref: '#/components/schemas/2be764ef53499e28cc8da8dff3890f0787860aba10984e520352c73612c0342b.ResourceAssociationResponse'
paging:
$ref: '#/components/schemas/2be764ef53499e28cc8da8dff3890f0787860aba10984e520352c73612c0342b.PageInfo'
title: PageResourceAssociation
b1075107f5bba728f6a701eb8a72357dfcf0d9c4405dd06e85e56496153a8d2f.GrantType:
type: string
description: Grant type as defined by the OAuth framework.
enum:
- client_credentials
- 'authorization_code '
title: GrantType
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageBodyType:
type: string
enum:
- TEXT
- IMAGE
- VIDEO
- DOCUMENT
- RICH_LINK
- AUTHENTICATION_REQUEST
- LIST
- CAROUSEL
- LOCATION
- CONTACT
- STICKER
- PRODUCT
- MIXED
- FLOW
- TIME_PICKER
- ORDER_REQUEST
- ORDER_STATUS
- FORM
title: MessagesApiMessageBodyType
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MmsAction:
type: object
description: Forward action configuration.
discriminator:
propertyName: type
mapping:
HTTP_FORWARD: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MmsHttpForwardAction'
PULL: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MmsPullAction'
NO_ACTION: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MmsNoAction'
properties:
type:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MoActionType'
description:
type: string
description: Additional action description.
title: MmsAction
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.UploadDocumentApiDoc:
type: object
properties:
document:
type: string
format: binary
description: 'The document file you want to upload. Supported file formats: .doc, .docx, .jpg, .jpeg, .png, .pdf, .xls, .xlsx, .mp4, .avi, .mov, .webm'
required:
- document
title: UploadDocumentApiDoc
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.ResponseEnvelopeMessageResponseMessageResponseDetails:
type: object
properties:
bulkId:
type: string
description: Unique ID assigned to the request if messaging multiple recipients or sending multiple messages via a single API request. If not provided, it will be auto-generated and returned in the API response. Typically used for fetching delivery reports and message logs.
messages:
type: array
description: An array of message objects of a single message or multiple messages sent under one bulk ID.
items:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessageResponseMessageResponseDetails'
required:
- messages
title: ResponseEnvelopeMessageResponseMessageResponseDetails
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandStatus:
type: object
properties:
registrar:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandRegistrar'
state:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandRegistrationStatusPublic'
brandIdentityStatus:
type: string
description: The status of the brand as determined by the registrar.
enum:
- SELF_DECLARED
- UNVERIFIED
- VERIFIED
- VETTED_VERIFIED
example: UNVERIFIED
brandAuthenticationStatus:
type: string
description: The status of brand authentication applicable for TENDLC_PUBLIC_COMPANY brand type.
enum:
- PENDING
- ACTIVE
- FAILED
- EXPIRED
example: PENDING
rejectionReason:
type: string
description: The reason for brand registration rejection.
example: Invalid country code.
title: BrandStatus
ApiException:
type: object
properties:
requestError:
$ref: '#/components/schemas/ApiRequestError'
title: ApiException
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlySecurityRequest:
type: object
description: Security settings object holding authentication settings necessary to access your webhook.
properties:
authId:
type: string
description: Unique security setting ID. You can provide this ID if you want to associate your subscription with a different notification profile.
maxLength: 255
minLength: 1
required:
- authId
title: Security
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.ResourceOrderStatus:
type: string
description: Current status of the resource request.
enum:
- PENDING
- UPDATE_REQUESTED_BY_INTERNAL_REVIEWER
- CANCELED
- AUTOMATIC_VALIDATION
- UPDATE_REQUESTED
- REJECTED
- COMPLETED
- PENDING_REVIEW
- IN_REVIEW
- IN_PROGRESS
- CANCEL_REQUESTED
title: ResourceOrderStatus
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.HmacCredentialsPayload:
type: object
description: HMAC credentials.
properties:
secretKey:
type: string
description: Secret key.
maxLength: 255
minLength: 1
algorithm:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.HmacAlgorithm'
required:
- algorithm
- secretKey
title: HmacCredentials
bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.CreateSessionRequest:
type: object
properties:
username:
type: string
description: Username of the user.
password:
type: string
description: Password of the user.
unsafe:
type: boolean
description: Create session which is not bound to IP.
required:
- password
- username
title: CreateSessionRequest
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.IbResourceType:
type: string
description: Resource type.
enum:
- ALPHANUMERIC
- NUMBER
- RCS_RESOURCE
- VIBER_RESOURCE
- APPLE_RESOURCE
- OPEN_CHANNEL_RESOURCE
- KAKAO_RESOURCE
- FACEBOOK_RESOURCE
example: FACEBOOK_RESOURCE
title: IbResourceType
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleNumberLookupEvents:
type: string
enum:
- NUMBER_LOOKUP
title: Event
4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611.PublicCnamDeliveryStatus:
type: object
description: Current status of CNAM Delivery configuration.
properties:
status:
$ref: '#/components/schemas/4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611.Status'
reason:
type: string
description: Description of the status.
title: PublicCnamDeliveryStatus
e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.CatalogDto:
type: object
properties:
id:
type: integer
format: int64
description: Catalog ID.
example: 10000
name:
type: string
description: Catalog name.
example: Catalog Name
description:
type: string
description: Catalog description.
example: Catalog description
type:
$ref: '#/components/schemas/e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.CatalogTypes'
required:
- description
- id
- name
- type
title: CatalogDto
5929f45c31f06c29ab1bc6e26caa01575484225e5ef99a2512bee829b646f1c1.Platform:
type: object
description: Platform options. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
properties:
entityId:
type: string
description: Used when specifying an entity in outbound send requests. It is also returned in notification events. For detailed usage, refer to the [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
maxLength: 255
minLength: 0
applicationId:
type: string
description: Used when specifying an application in outbound send requests. It is also returned in notification events. For detailed usage, refer to the [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).
maxLength: 255
minLength: 0
title: Platform
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.UploadDocumentApiDoc:
type: object
properties:
document:
type: string
format: binary
description: The document file to be uploaded.
required:
- document
title: UploadDocumentApiDoc
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.OutboundMessageChannel:
type: string
description: Messaging channel used for sending a message.
enum:
- APPLE_MB
- INSTAGRAM_DM
- LINE_ON
- MESSENGER
- MMS
- RCS
- SMS
- VIBER_BM
- VIBER_BOT
- WHATSAPP
title: OutboundMessageChannel
4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611.StatusResponse:
type: object
description: Current status of Emergency Service configuration.
properties:
status:
$ref: '#/components/schemas/4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611.Status'
reason:
type: string
description: Description of the status.
title: StatusResponse
e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.CatalogValueDto:
type: object
description: A list of item field values. Maximum 1000 values.
properties:
fieldName:
type: string
description: Field name.
example: Custom field name
fieldId:
type: string
description: Field ID.
example: 8b00a8c6-5302-4fd0-a0cc-bb090b28ac34
value:
type: string
description: Field value.
example: Custom field value
required:
- fieldId
- fieldName
- value
title: CatalogValueDto
7635fa9e013ed171bbe9743a6ca322c3b2b29e7574931e38f0de0bda9687aadf.EmergencyAddress:
type: object
properties:
enabled:
type: boolean
default: false
description: Indicates whether configuration is enabled or not.
address:
$ref: '#/components/schemas/4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611.Address'
required:
- address
- enabled
title: EmergencyAddress
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleMobileIdentityEvents:
type: string
enum:
- SILENT_VERIFICATION
title: Event
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.DeliveryTimeWindow:
type: object
description: Sets specific message delivery window outside of which messages won't be delivered. Often, used when there are restrictions on when messages can be sent. The exact time of the day to start sending messages can be defined using the `from` property. The exact time of the day to end sending messages can be defined using the `to` property. Properties `from` and `to` should be both provided with the minimum 1 hour difference or omitted.
properties:
days:
type: array
description: Days of the week which are included in the delivery time window. At least one day must be provided. Separate multiple days with a comma.
items:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.DeliveryDay'
from:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.DeliveryTime'
to:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.DeliveryTime'
required:
- days
title: DeliveryTimeWindow
2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.BlocklistResponse:
type: object
description: Blocklist response.
properties:
sender:
type: string
description: The sender ID for which blocklist happened.
destination:
type: string
description: Blocklisted destination address.
sourceType:
$ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.SourceType'
channel:
$ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.ViewableChannel'
accountKey:
type: string
description: Account connected with a blocklist record. Main account has access to blocklist records of their subaccounts. Subaccounts can only access blocklist records specific to them. [API to retrieve account key](https://www.infobip.com/docs/api/platform/account-management/get-all-accounts).
createdDate:
type: string
format: date-time
description: Timestamp of created blocklist record.
campaign:
type: string
format: string
description: ID that allows you to track, analyze, and show an aggregated overview and the performance of individual campaigns per sending channel.
required:
- accountKey
- createdDate
- destination
- sourceType
title: BlocklistResponse
2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.EventSourceType:
type: string
description: 'Represents the way blocklist record was created:
MO - blocklist record automatically created once an end user unsubscribes by replying with a specific keyword (e.g.: STOP). This is applicable for the following channels: SMS, MMS.
URL_OPT_OUT - blocklist record automatically created once an end user clicks an opt-out link included in the message.
CAMPAIGN - blocklist record automatically created through a triggered event in the Flow (e.g., if the message was not opened in 24h, add to blocklist).'
enum:
- MO
- URL_OPT_OUT
- CAMPAIGN
title: EventSourceType
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandVetStatusWebhookResponse:
type: object
properties:
results:
type: array
description: Incoming events
items:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandVetStatusWebhookMessage'
title: BrandVetStatusWebhookResponse
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SubscriptionChannel:
type: string
enum:
- AGENT_OS
- APPLE_MESSAGES_FOR_BUSINESS
- BLOCKLIST
- CUSTOMER_ENGAGEMENT
- EMAIL
- FACEBOOK
- KAKAO_ALIM
- KAKAO_BRAND_MESSAGE
- LINE
- MMS
- MOBILE_IDENTITY
- MOBILE_PUSH
- NUMBER_LOOKUP
- OPEN_CHANNEL
- RCS
- REGISTRATION
- SMS
- VIBER
- VOICE_VIDEO
- WEB_PUSH
- WHATSAPP
- ZALO
title: SubscriptionChannel
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiBaseMessage:
type: object
description: Array of message objects of a single message or multiple messages sent under one bulk ID.
oneOf:
- $ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessage'
- $ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateMessage'
title: MessagesApiBaseMessage
bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.ApiKey:
type: object
properties:
id:
type: string
description: Unique identifier specifying this api key.
apiKeySecret:
type: string
description: Authentication key. Use this value for authentication on API. Keep this in secure storage and don't share it.
accountId:
type: string
description: Unique identifier for account this API key belongs to.
name:
type: string
description: Name of this API Key.
allowedIPs:
type: array
description: List of allowed IP addresses from which this API key will be used. Authentication will fail from any other IP not specified in this list.
items:
type: string
description: List of allowed IP addresses from which this API key will be used. Authentication will fail from any other IP not specified in this list.
validFrom:
type: string
format: date-time
description: Date from which this API key is/will be valid. Time is in UTC.
validTo:
type: string
format: date-time
description: Date until this API key will be valid. Time is in UTC.
enabled:
type: boolean
description: Is API key enabled.
permissions:
type: array
description: List of permissions this API key has granted.
items:
type: string
description: List of permissions this API key has granted.
uniqueItems: true
platform:
type: array
description: A collection of CPaaS X Applications and/or Entities associated with the API Key
items:
$ref: '#/components/schemas/bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.Platform'
scopeGuids:
type: array
description: List of Scopes assigned to API Key
items:
type: string
description: List of Scopes assigned to API Key
uniqueItems: true
required:
- name
title: ApiKey
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.PriorityTimeUnit:
type: string
description: The unit of time for the priority request.
enum:
- HOURS
- DAYS
title: PriorityTimeUnit
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.PageResourceOrderApiDoc:
type: object
properties:
results:
type: array
description: The list of the results for this page.
items:
type: object
description: The list of the results for this page.
oneOf:
- $ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.AlphaResourceOrderApiDoc'
- $ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.NumberResourceOrderApiDoc'
- $ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.RcsSenderResourceOrderApiDoc'
paging:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.PageInfo'
title: PageResourceOrderApiDoc
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.CertificateUploadRequest:
type: object
properties:
certificateId:
type: string
description: Certificate's identifier. This identifier will be used as part of a URL path and must not include any characters that require URL encoding. You cannot change the ID once an item is created.
maxLength: 255
minLength: 1
certificateContent:
type: string
format: base64
description: Content of a .pem file encoded in Base64 format.
passphrase:
type: string
format: base64
description: Certificate's passphrase encoded in Base64 format.
required:
- certificateContent
- certificateId
title: CertificateUploadRequest
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleMmsEvents:
type: string
enum:
- CLICK
- DELIVERY
- INBOUND_MESSAGE
title: Event
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateMessage:
type: object
description: Represents a single template message.
properties:
channel:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.OutboundTemplateChannel'
sender:
type: string
description: The sender ID. It can be alphanumeric or numeric (e.g., `CompanyName`). Make sure you don't exceed [character limit](https://www.infobip.com/docs/sms/get-started#sender-names).
destinations:
type: array
description: Array of destination objects for where messages are being sent. A valid destination is required. **`Channels Destination` is required when sending messages with defined failover.**
items:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessageDestination'
template:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplate'
content:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateMessageContent'
options:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiMessageOptions'
webhooks:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiWebhooks'
failover:
type: array
description: Provides options for configuring a message failover. When message fails it will be sent over channels in order specified in an array. It has to contain unique entries per channel and it cannot contain entry with the same channel as original message. **Make sure to provide correct sender and destinations specified as `Channels Destination` for each channel**.
items:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiBaseFailover'
required:
- channel
- destinations
- template
title: Messages API template message
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ConnectionTestResult:
type: string
description: Connection test result. Indicates whether the test to connection passed.
enum:
- SUCCESS
- FAIL
title: ConnectionTestResult
96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiException:
type: object
properties:
requestError:
allOf:
- $ref: '#/components/schemas/96ea7b6cea267e43daadde063d93b8799cdb795baa0e9344573e0f63283595e0.ApiRequestError'
title: ApiException
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignAiFeedbackWebhookMessage:
type: object
description: Incoming events
properties:
event:
type: string
description: The name of the event.
enum:
- AI_CAMPAIGN_FEEDBACK
example: AI_CAMPAIGN_FEEDBACK
receivedAt:
type: string
format: date-time
description: Date and time when Infobip received the event.
content:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignAiFeedbackWebhookContent'
platform:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignWebhookPlatform'
title: CampaignAiFeedbackWebhookMessage
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.RcsRequirementSpecsRequestApiDoc:
type: object
properties:
type:
type: string
description: Type of resource.
enum:
- RCS_SENDER_LAUNCH
countryCode:
type: string
description: Country code in two-letter ISO standard.
excludedCarriers:
type: array
description: List of carrier names excluded from the sender launch.
items:
type: string
description: List of carrier names excluded from the sender launch.
trafficOrigin:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.TrafficOrigin'
required:
- countryCode
- trafficOrigin
- type
title: RCS_SENDER_LAUNCH
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.WebPushNoIdSubscriptionRequest:
type: object
description: Subscription group.
properties:
name:
type: string
description: Subscription group name.
maxLength: 255
minLength: 1
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyProfileRequest'
events:
type: array
description: List of events available for subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](/docs/cpaas-x/subscriptions-management#availability). In case you are configuring inbound Subscription please check all the details [available here](/docs/cpaas-x/subscriptions-management#inbound-message-configuration).
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleWebPushEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
required:
- events
- profile
title: Web Push
c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.CreateSmsOrVoiceMessageRequest:
type: object
properties:
language:
allOf:
- $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.Language'
description: The language code which message is written in used when sending text-to-speech messages. If not defined, it will default to English (`en`).
readOnly: false
writeOnly: true
messageText:
type: string
description: Content of the message being sent which contains at minimum one placeholder for a PIN code (`{{pin}}`). Placeholder format is `{{placeholderName}}`.
readOnly: false
writeOnly: true
pinLength:
type: integer
format: int32
description: PIN code length.
readOnly: false
writeOnly: true
pinType:
allOf:
- $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.PinType'
description: Type of PIN code that will be generated and sent as part of 2FA message.
readOnly: false
writeOnly: true
regional:
allOf:
- $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.RegionalOptions'
description: Region-specific parameters, often imposed by local laws. Use this, if country or region that you are sending a message to requires additional information.
readOnly: false
writeOnly: true
repeatDTMF:
type: string
description: If the PIN is sent as a voice message, the DTMF code allows the recipient to replay the message.
readOnly: false
writeOnly: true
senderId:
type: string
description: 'The name that will appear as the sender of the 2FA message (Example: CompanyName).'
readOnly: false
writeOnly: true
speechRate:
type: number
format: double
description: The speed of narration for messages sent as voice. Supported range is from `0.5` to `2`.
readOnly: false
writeOnly: true
voiceName:
type: string
description: 'Defines the voice that will be used for the chosen language (example: Joanna). For each supported language, we may offer different voices (learn more [here](https://www.infobip.com/docs/voice-and-video/reference#text-to-speech-languages)). You can use this [method](https://www.infobip.com/docs/api/channels/voice/voice-message/get-voices) to retrieve all voices for the given language. If not defined, it will default to the standard voice for the selected language (if available). If the standard voice is not available, the request will fail. To avoid that, you can choose one of the neural voices (charges will apply).'
readOnly: false
writeOnly: true
required:
- messageText
- pinType
title: CreateSmsOrVoiceMessageRequest
c477cb65646267e3f350bce7b433e9b56e5c28aa9ef21a75500a1337942923ba.Cnam:
type: object
properties:
storage:
$ref: '#/components/schemas/4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611.CnamStorage'
delivery:
$ref: '#/components/schemas/4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611.CnamDelivery'
title: Cnam
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.RequirementSpecs:
type: object
properties:
requirements:
type: array
description: List of requirements needed for the resource request.
items:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.RequirementSpec'
title: RequirementSpecs
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.BlockLevelResponse:
type: string
description: The level of block configuration. If the value is CUSTOM_NOT_EDITABLE, then the value is not manageable by API.
enum:
- FROM_SENDER
- FROM_ANY_SENDER
- CUSTOM_NOT_EDITABLE
title: BlockLevelResponse
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandRegistrationWebhookMessage:
type: object
description: Incoming events
properties:
event:
type: string
description: The name of the event.
enum:
- BRAND_STATUS_UPDATE
example: BRAND_STATUS_UPDATE
receivedAt:
type: string
format: date-time
description: Date and time when Infobip received the event.
content:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandRegistrationWebhookContent'
platform:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandWebhookPlatform'
title: BrandRegistrationWebhookMessage
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ZaloSubscriptionRequest:
type: object
description: Subscription group.
properties:
subscriptionId:
type: string
description: Subscription ID. Used as part of a URL path and must not include any characters that require URL encoding. You cannot change the ID once a subscription is created.
maxLength: 255
minLength: 1
name:
type: string
description: A human-readable description for your subscription, can be changed at a later point.
maxLength: 255
minLength: 1
events:
type: array
description: List of events available for a subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](https://www.infobip.com/docs/cpaas-x/subscriptions-management/event-subscriptions). If configuring inbound Subscription, check [inbound message configuration docs](https://www.infobip.com/docs/cpaas-x/subscriptions-management/inbound-message-configuration).
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleZaloEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfileRequest'
required:
- events
- profile
- subscriptionId
title: Zalo
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.ResourceOrderApiDoc:
type: object
discriminator:
propertyName: type
oneOf:
- $ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.AlphaResourceOrderApiDoc'
- $ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.NumberResourceOrderApiDoc'
- $ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.RcsSenderResourceOrderApiDoc'
title: ResourceOrderApiDoc
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.NumberOfferClientType:
type: string
description: Type of client. LOCAL resolves numbers preferring local options, falling back to international if none are available. INTERNATIONAL and null resolve international numbers only.
enum:
- LOCAL
- INTERNATIONAL
title: NumberOfferClientType
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiOutboundEvent:
type: object
description: Array of event objects of a single event or multiple events sent
discriminator:
propertyName: event
mapping:
TYPING_STARTED: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiOutboundTypingStartedEvent'
TYPING_STOPPED: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiOutboundTypingStoppedEvent'
SEEN: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiOutboundSeenEvent'
properties:
event:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiOutboundEventType'
required:
- event
title: MessagesApiOutboundEvent
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.PromotionMethodType:
type: string
description: Call-to-action promotion method type
enum:
- OUTDOOR
- POS
- PRINT
- RADIO
- TV
- WEB
title: PromotionMethodType
99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.TimeBucket:
type: string
enum:
- SECONDS_0
- SECONDS_1
- SECONDS_2
- SECONDS_3
- SECONDS_4
- SECONDS_5
- SECONDS_10
- SECONDS_15
- SECONDS_20
- SECONDS_25
- SECONDS_30
- SECONDS_40
- SECONDS_50
- MINUTES_1
- MINUTES_2
- MINUTES_3
- MINUTES_4
- MINUTES_5
- MINUTES_10
- MINUTES_15
- MINUTES_20
- MINUTES_25
- MINUTES_30
- MINUTES_45
- HOURS_1
- HOURS_6
- HOURS_12
- HOURS_18
- DAYS_1
- DAYS_2
- DAYS_3
title: TimeBucket
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.CampaignBuilderResponse:
type: object
description: Response containing the request UUID for tracking the started campaign builder
properties:
requestUuid:
type: string
format: uuid
description: Unique identifier for this campaign builder.
title: CampaignBuilderResponse
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.AppleMessagesForBusinessSubscriptionRequest:
type: object
description: Subscription group.
properties:
subscriptionId:
type: string
description: Subscription ID. Used as part of a URL path and must not include any characters that require URL encoding. You cannot change the ID once a subscription is created.
maxLength: 255
minLength: 1
name:
type: string
description: A human-readable description for your subscription, can be changed at a later point.
maxLength: 255
minLength: 1
events:
type: array
description: List of events available for a subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](https://www.infobip.com/docs/cpaas-x/subscriptions-management/event-subscriptions). If configuring inbound Subscription, check [inbound message configuration docs](https://www.infobip.com/docs/cpaas-x/subscriptions-management/inbound-message-configuration).
items:
oneOf:
- $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleAppleMessagesForBusinessEvents'
- $ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.FormatAwareAppleMessagesForBusinessEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could only be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ProfileRequest'
required:
- events
- profile
- subscriptionId
title: Apple Messages For Business
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.PageInfo:
type: object
description: Contains information about the page.
properties:
page:
type: integer
format: int32
description: Requested page number.
minimum: 0
size:
type: integer
format: int32
description: Requested page size.
minimum: 1
totalPages:
type: integer
format: int32
description: The total number of pages of the results matching the requested parameters.
minimum: 0
totalResults:
type: integer
format: int64
description: The total number of the results matching the requested parameters.
minimum: 0
required:
- page
- size
- totalPages
- totalResults
title: PageInfo
66067ae938b1b756af79ad29184e7a22de98929ca991ca01a0c74d258f22a0b6.BalanceInfoResponse:
type: object
properties:
balance:
type: number
allowedMinus:
type: number
monthlyLimit:
type: number
monthlyBalance:
type: number
currency:
$ref: '#/components/schemas/66067ae938b1b756af79ad29184e7a22de98929ca991ca01a0c74d258f22a0b6.SimpleCurrencyInfo'
freeMessages:
type: object
additionalProperties:
type: integer
format: int32
title: BalanceInfoResponse
e6e93dd514df725f71bff0da51b4f6588e807f5cb84f3d1063a226fc7a7537eb.UpdateCatalogDto:
type: object
properties:
name:
type:
- string
- 'null'
description: Catalog name.
example: CatalogName
description:
type:
- string
- 'null'
description: Catalog description.
example: Just a description
title: UpdateCatalogDto
99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.ColumnInfo:
type: object
description: Information about columns returned in response.
properties:
columnName:
type: string
description: Name of the column.
columnDataType:
$ref: '#/components/schemas/99c561addf74bb07fd67942658f68818323ce564cc5eef645d487517ca1425f2.ColumnDataType'
required:
- columnDataType
- columnName
title: ColumnInfo
6ac22f6f3346b6db1d4c8464d58b1329c30df516bb4206699a93fd8658df38c7.TrustedMsisdnCheckResponse:
type: object
description: Trusted MSISDN check response object.
properties:
exists:
type: boolean
description: Whether the provided phone number exists in the trusted MSISDN list.
title: TrustedMsisdnCheckResponse
17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationResponse:
type: object
properties:
applicationId:
type: string
description: The ID of the application that represents your service, e.g. 2FA for login, 2FA for changing the password, etc.
readOnly: true
writeOnly: false
configuration:
allOf:
- $ref: '#/components/schemas/17363474057d152577564d8587b079aa7bdd070a3f49746aea3319eb57a5830c.ApplicationConfiguration'
description: Created 2FA application configuration.
readOnly: true
writeOnly: false
enabled:
type: boolean
description: Indicates whether the created application is enabled.
readOnly: true
writeOnly: false
name:
type: string
description: 2FA application name.
readOnly: true
writeOnly: false
title: ApplicationResponse
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.InboundMoGetEndpointChannel:
type: string
enum:
- APPLE_MB
- MESSENGER
- MMS
- SMS
- VIBER_BM
- WHATSAPP
title: InboundMoGetEndpointChannel
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.KeywordOptIn:
type: object
description: The type of opt in that requires a user to type in a keyword.
properties:
callToAction:
type: string
description: " The message sent to the user to tell them how to subscribe. Must include:\n • Product description\n • Message frequency disclosure\n • Complete terms and conditions OR link to complete terms and conditions\n • Privacy policy OR link to privacy policy\n • STOP keyword\n • The \"Message and data rates may apply\" disclosure\n"
maxLength: 1024
minLength: 20
keywords:
type: array
description: The keyword(s) the user will text to subscribe. Keyword(s) must include only uppercase letters and numbers.
items:
type: string
description: The keyword(s) the user will text to subscribe. Keyword(s) must include only uppercase letters and numbers.
pattern: '[A-Z0-9]+'
required:
- callToAction
- keywords
title: KeywordOptIn
2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.BlocklistEventType:
type: string
description: Blocklist event type.
enum:
- BLOCK
- UNBLOCK
title: BlocklistEventType
b1075107f5bba728f6a701eb8a72357dfcf0d9c4405dd06e85e56496153a8d2f.TokenResponse:
type: object
description: Successful response that indicates OAuth2 token was created.
properties:
access_token:
type: string
description: OAuth2 token.
expires_in:
type: integer
format: int32
description: OAuth2 token expiration in seconds.
token_type:
type: string
description: OAuth2 token type.
title: TokenResponse
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyCertificateResponse:
type: object
properties:
certificateId:
type: string
description: Certificate identifier.
title: IdOnlyCertificateResponse
bb8af9c2d2d4d677e25555100e31662e23d86ede8b5d73bbf4974b4decdd08d7.Action:
type: string
description: An optional action performed for an API request authenticated by this specific API key. The `FILL` option is used when an API endpoint inserts linked Application and Entity IDs into a request, if missing. The `FORCE` option is used when an API endpoint overrides linked Application and Entity IDs with the ones from this platform. If the action is left blank, the API endpoint will only perform an authorization check without injecting values into the request.
enum:
- FILL
- FORCE
title: Action
4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611.Address:
type: object
description: Address of an Emergency Service.
properties:
name:
type: string
description: Emergency Service address name.
maxLength: 100
minLength: 0
streetName:
type: string
description: Emergency Service address street.
maxLength: 100
minLength: 0
streetNumber:
type: string
description: Emergency Service address street number.
maxLength: 20
minLength: 0
city:
type: string
description: Emergency Service address city.
maxLength: 50
minLength: 0
countryCode:
type: string
description: Emergency Service address country code.
maxLength: 2
minLength: 2
stateCode:
type: string
description: Emergency Service address state code.
maxLength: 2
minLength: 2
zipCode:
type: string
description: Emergency Service address zip code.
maxLength: 10
minLength: 5
direction:
$ref: '#/components/schemas/4527871876f1b326359cd9e5dcf777f0ecc3c5fde89b1e88f0c154b298b67611.Direction'
suite:
type: string
description: Emergency Service address suite.
required:
- city
- countryCode
- name
- stateCode
- streetName
- streetNumber
- zipCode
title: Address
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.DeliveryTimeZoneResponse:
type: string
description: Sending time zone. If the value is CUSTOM_NOT_EDITABLE, then the value is not manageable by API.
enum:
- USER_TIME_ZONE
- DESTINATION_TIME_ZONE
- CUSTOM_NOT_EDITABLE
title: DeliveryTimeZoneResponse
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandAppealsResponse:
type: object
description: Response containing the list of all appeals submitted for a brand.
properties:
appeals:
type: array
description: List of appeals submitted for the brand, ordered from most recent to oldest.
items:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.BrandAppealPreview'
title: BrandAppealsResponse
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.MobilePushNoIdSubscriptionRequest:
type: object
description: Subscription group.
properties:
name:
type: string
description: Subscription group name.
maxLength: 255
minLength: 1
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyProfileRequest'
events:
type: array
description: List of events available for subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](/docs/cpaas-x/subscriptions-management#availability). In case you are configuring inbound Subscription please check all the details [available here](/docs/cpaas-x/subscriptions-management#inbound-message-configuration).
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleMobilePushEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
required:
- events
- profile
title: Mobile Push
6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.AgentOsNoIdSubscriptionRequest:
type: object
description: Subscription group.
properties:
name:
type: string
description: Subscription group name.
maxLength: 255
minLength: 1
profile:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.IdOnlyProfileRequest'
events:
type: array
description: List of events available for subscription. Note that a set of events available for each channel is different; subscription to events that are unavailable for a certain channel will be ignored. For more details, see the [availability table](/docs/cpaas-x/subscriptions-management#availability). In case you are configuring inbound Subscription please check all the details [available here](/docs/cpaas-x/subscriptions-management#inbound-message-configuration).
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.SimpleAgentOsEvents'
maxItems: 255
minItems: 0
criteria:
type: array
description: Application and Entity pair to match. You can set the rule to match only Application or only Entity if necessary, omitting the other item.
items:
$ref: '#/components/schemas/6e71a232d29cf86cbe8cd24bd719c2050de4613347854f985c920dd3d0d3e33f.ApplicationEntityPair'
maxItems: 255
minItems: 0
resources:
type: array
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
items:
type: string
description: List of resources to match. At the moment, this could be a sender name (whether numeric or alpha) used on message submit.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
users:
type: array
description: List of users to match. You can provide usernames from your account.
items:
type: string
description: List of users to match. You can provide usernames from your account.
maxLength: 255
minLength: 0
x-is-early-access: 'true'
maxItems: 255
minItems: 0
x-is-early-access: 'true'
required:
- events
- profile
title: AgentOS
2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.BlocklistDelete:
type: object
description: Blocklist.
properties:
destinations:
type: array
description: Destination addresses that need to be removed from blocklist.
items:
$ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.ToDelete'
sender:
type: string
description: The sender ID that needs to be removed from blocklist. Sender can be alphanumeric or numeric.
maxLength: 255
minLength: 1
channel:
$ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.DeletableChannel'
accountKey:
type: string
description: Account for which blocklist record/s will be removed. Main account can remove blocklist record/s for their subaccounts. Subaccounts can remove blocklist record/s specific to them. [API to retrieve account key](https://www.infobip.com/docs/api/platform/account-management/get-all-accounts).
sourceType:
$ref: '#/components/schemas/2c1d05f3dc2f46851efe83e0fa7d26e3f8a2e8ee522f9adaaba58b0a33a2be33.SourceType'
required:
- destinations
title: BlocklistDelete
2be764ef53499e28cc8da8dff3890f0787860aba10984e520352c73612c0342b.PageInfo:
type: object
properties:
page:
type: integer
format: int32
description: Requested page number.
minimum: 0
size:
type: integer
format: int32
description: Requested page size.
minimum: 1
totalPages:
type: integer
format: int32
description: The total number of pages of the results matching the requested parameters.
minimum: 0
totalResults:
type: integer
format: int64
description: The total number of the results matching the requested parameters.
minimum: 0
required:
- page
- size
- totalPages
- totalResults
title: PageInfo
2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.Priority:
type: object
properties:
priorityId:
type: string
format: uuid
description: The ID for the campaign priority.
dailySubmitLimit:
type: integer
format: int32
description: The limit on how many campaigns you can submit a day with this priority.
reviewTime:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.PriorityTimeData'
priorityType:
$ref: '#/components/schemas/2700ea5ecfd0574f21019319e90eb63416ede8263eab67e466c718c51cd1a77a.PriorityType'
title: Priority
c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.SmsOrVoiceMessage:
type: object
properties:
applicationId:
type: string
description: The ID of the application that represents your service (e.g. 2FA for login, 2FA for changing the password, etc.) for which the requested message has been created.
readOnly: false
writeOnly: false
language:
allOf:
- $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.Language'
description: The language code which message is written in used when sending text-to-speech messages. If not defined, it will default to English (`en`).
readOnly: false
writeOnly: false
messageId:
type: string
description: The ID of the message template (message body with the PIN placeholder) that is sent to the recipient.
readOnly: false
writeOnly: false
messageText:
type: string
description: Text of a message that will be sent. Message text must contain `pinPlaceholder`.
readOnly: false
writeOnly: false
pinLength:
type: integer
format: int32
description: PIN code length.
readOnly: false
writeOnly: false
pinPlaceholder:
type: string
description: The PIN code placeholder that will be replaced with a generated PIN code.
readOnly: false
writeOnly: false
pinType:
allOf:
- $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.PinType'
description: The type of PIN code that will be generated and sent as part of 2FA message. You can set PIN type to numeric, alpha, alphanumeric or hex.
readOnly: false
writeOnly: false
regional:
allOf:
- $ref: '#/components/schemas/c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.RegionalOptions'
description: Region specific parameters, often specified by local laws. Use this if country or region that you are sending SMS to requires some extra parameters.
readOnly: false
writeOnly: false
repeatDTMF:
type: string
description: In case PIN message is sent by Voice, DTMF code will enable replaying the message.
readOnly: false
writeOnly: false
senderId:
type: string
description: 'The name that will appear as the sender of the 2FA message (Example: CompanyName).'
readOnly: false
writeOnly: false
speechRate:
type: number
format: double
description: In case PIN message is sent by Voice, the speed of speech can be set for the message. Supported range is from `0.5` to `2`.
readOnly: false
writeOnly: false
voiceName:
type: string
description: 'Defines the voice that will be used for the chosen language (example: Joanna). For each supported language, we may offer different voices (learn more [here](https://www.infobip.com/docs/voice-and-video/reference#text-to-speech-languages)). You can use this [method](https://www.infobip.com/docs/api/channels/voice/voice-message/get-voices) to retrieve all voices for the given language. If not defined, it will default to the standard voice for the selected language (if available). If the standard voice is not available, the request will fail. To avoid that, you can choose one of the neural voices (charges will apply).'
readOnly: false
writeOnly: true
title: SmsOrVoiceMessage
7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MmsConfigurations:
type: object
properties:
configurations:
type: array
items:
$ref: '#/components/schemas/7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553.MmsConfiguration'
totalCount:
type: integer
format: int32
title: MmsConfigurations
899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateBody:
type: object
description: Body of a template message.
discriminator:
propertyName: type
mapping:
TEXT: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateTextBody'
CAROUSEL: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateCarouselBody'
properties:
type:
$ref: '#/components/schemas/899caf445aab842b03fe1d74e4afd7097f0161dae66538ffa05bba2f153d708f.MessagesApiTemplateBodyType'
required:
- type
title: MessagesApiTemplateBody
c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.ProcuredNumber:
type: object
description: List of numbers linked with the resource.
properties:
number:
type: string
description: Number.
numberKey:
type: string
description: Unique ID of a number.
status:
$ref: '#/components/schemas/c8df889022018062dfcb44e930a391e7e1c8e669bd11a10a717da508b9ae3dcf.NumberStatus'
required:
- number
- status
title: ProcuredNumber
c3b21d2ffef2552e10577daa67c904ac80618665b001ef386a4faefc515e78f3.EmailMessage:
type: object
properties:
applicationId:
type: string
description: The ID of the application that represents your service (e.g. 2FA for login, 2FA for changing the password, etc.) for which the requested message has been created.
readOnly: false
writeOnly: false
emailTemplateId:
type: integer
format: int64
description: Email template ID that should reference a previously created Email template.
readOnly: false
writeOnly: false
from:
type: string
description: The sender of the 2FA message, an email address with an optional sender name (e.g. `company@example.com` or `Jane Smith NULL will set keyword to NULL because it is a valid keyword which will match all values.
example: STARTKW
maxLength: 50
minLength: 0
username:
type: string
description: Sets username that will be applied in appropriate actions.
example: myusername
maxLength: 255
minLength: 0
pattern: ^(?!\s*$).+
unset:
type: array
description: Used for unsetting configuration options.