Infobip

6.0.0 · active · verified Fri Mar 27

Official Python client for Infobip communications APIs (SMS, WhatsApp, Email, Voice). Current version is 6.0.0 (Jan 2026). Requires Python >=3.9. Auto-generated from OpenAPI spec — every major version contains breaking changes. Requires account-specific base URL (not a generic endpoint). Two separate packages exist: the official infobip-api-python-client and the community infobip-api-python-sdk.

Warnings

breaking Every major version of infobip-api-python-client contains breaking changes. The library is auto-generated from OpenAPI spec — model names, method signatures, and endpoint paths change between versions. Code written for v3 will not work on v5 or v6.
Fix: Pin the version in requirements.txt. Read the CHANGELOG before upgrading: https://github.com/infobip/infobip-api-python-client/releases
breaking Account-specific base URL is required. Using a generic URL like https://api.infobip.com causes authentication failures. Each Infobip account has a unique subdomain assigned at account creation.
Fix: Find your base URL at app.infobip.com under API Keys or the API Resource Hub. Format: https://XXXXX.api.infobip.com
breaking SMS API endpoint changed: /sms/3/messages (V3) replaced /sms/2/text/advanced (V2) in v5.x. Email API /email/4/messages (V4) replaced /email/3/send (V3). Old endpoint paths and corresponding SDK methods are removed.
Fix: Update to the v3 SMS methods (send_sms_message) and v4 email methods. Check the CHANGELOG for exact method name changes.
breaking Python 3.8 support dropped in v6.0. Minimum is now Python 3.9.
Fix: Pin infobip-api-python-client<6.0 for Python 3.8 environments.
breaking HTTPS enforcement added in v6.0. Passing http:// as the host URL now raises ValueError at configuration time.
Fix: Always use https:// in the host URL. Remove any http:// base URLs from configuration.
gotcha Two separate packages exist: infobip-api-python-client (official, auto-generated, breaking changes each major) and infobip-api-python-sdk (community, different API style, last updated 2023). They have different import patterns and are not interchangeable.
Fix: Use infobip-api-python-client for the latest official API coverage. The community SDK (infobip-api-python-sdk) is unmaintained and missing recent endpoints.

Install

pip install infobip-api-python-client Official Infobip client (recommended)
pip install infobip-api-python-sdk Community SDK (alternative, different API style)

Imports

infobip_api_client

from infobip_api_client.api.sms_api import SmsApi
from infobip_api_client.api_client import ApiClient, Configuration
from infobip_api_client.models import SmsAdvancedTextualRequest, SmsDestination, SmsTextualMessage

# Account-specific base URL required — not a generic URL
configuration = Configuration(
    host='https://ACCOUNT_BASE_URL.api.infobip.com',  # from Infobip dashboard
    api_key={'APIKeyHeader': 'App YOUR_API_KEY'}
)

with ApiClient(configuration) as api_client:
    api_instance = SmsApi(api_client)
    request = SmsAdvancedTextualRequest(
        messages=[SmsTextualMessage(
            destinations=[SmsDestination(to='+14155551234')],
            from_='InfoSMS',
            text='Hello World!'
        )]
    )
    response = api_instance.send_sms_message(sms_advanced_textual_request=request)

Infobip uses account-specific base URLs. Every account gets a unique subdomain like xxxxx.api.infobip.com. Using a generic URL causes authentication failures. Find yours in the Infobip API Resource Hub dashboard.

Quickstart

Send SMS via Infobip. Account-specific base URL is mandatory.

from infobip_api_client.api.sms_api import SmsApi
from infobip_api_client.api_client import ApiClient, Configuration
from infobip_api_client.models import (
    SmsAdvancedTextualRequest,
    SmsDestination,
    SmsTextualMessage
)

# Get base_url from: app.infobip.com → API Keys
configuration = Configuration(
    host='https://XXXXX.api.infobip.com',
    api_key={'APIKeyHeader': 'App YOUR_API_KEY'}
)

with ApiClient(configuration) as api_client:
    sms_api = SmsApi(api_client)
    
    request = SmsAdvancedTextualRequest(
        messages=[
            SmsTextualMessage(
                destinations=[SmsDestination(to='+14155551234')],
                from_='InfoSMS',
                text='Hello from Infobip!'
            )
        ]
    )
    
    response = sms_api.send_sms_message(
        sms_advanced_textual_request=request
    )
    print(response.messages[0].message_id)

view raw JSON →