Python SDK

Setup & Initialization

  1. Install Package:
pip install pingram-python
  1. Import:
from pingram import Pingram, PingramRegion
  1. Initialize and use as async context manager:
import asyncio
async def main():
async with Pingram(api_key="pingram_sk_...") as client:
# Use client methods here
pass
asyncio.run(main())
Name Type Description
api_key* string Your Pingram API key. You can get it from your dashboard under Environments.
region string Optional. Region: "us" (default), "eu", or "ca".
base_url string Optional. Override the base URL directly. Use https://api.ca.pingram.io for the Canada region, and https://api.eu.pingram.io for the EU region.

* required

Region specific example:

import asyncio
async def main():
async with Pingram(api_key="pingram_sk_...", region="eu") as client:
# Use client methods here
pass
asyncio.run(main())

Or using base_url directly:

import asyncio
async def main():
async with Pingram(api_key="pingram_sk_...", base_url="https://api.eu.pingram.io") as client:
# Use client methods here
pass
asyncio.run(main())

Send

send()

Send a notification (email, SMS, etc.) to one user

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
sender_post_body = SenderPostBody()
response = await client.send(sender_post_body)
print(response)

Parameters

Name Type Description Notes
sender_post_body SenderPostBody See Request Body Properties below

Request Body Properties

Name Type Description
type string ID of the notification type (e.g. “welcome_email”). Creates a new notification if it does not exist.
to object Recipient user. Provide id, email, or number to identify the user.
to.id string Unique user identifier. Required.
to.email string User’s email address for email notifications.
to.number string User’s phone number for SMS/call notifications.
to.pushTokens object[] Mobile push tokens (FCM, APN) for push notifications.
to.pushTokens[].type “FCM” | “APN” (required)
to.pushTokens[].token string (required)
to.pushTokens[].device object (required)
to.pushTokens[].device.app_id string
to.pushTokens[].device.ad_id string
to.pushTokens[].device.device_id string (required)
to.pushTokens[].device.platform string
to.pushTokens[].device.manufacturer string
to.pushTokens[].device.model string
to.pushTokens[].environment string used by APN to differentiate between sandbox and production builds (sandbox/undefined or production)
to.webPushTokens object[] Web push subscription config from the browser.
to.webPushTokens[].sub object (required) Configuration for a Push Subscription. This can be obtained on the frontend by calling serviceWorkerRegistration.pushManager.subscribe(). The expected format is the same output as JSON.stringify’ing a PushSubscription in the browser.
to.webPushTokens[].sub.endpoint string (required)
to.webPushTokens[].sub.keys object (required)
to.webPushTokens[].sub.keys.p256dh string (required)
to.webPushTokens[].sub.keys.auth string (required)
to.timezone string User’s timezone (e.g. “America/New_York”) for scheduling.
to.slackChannel string The destination channel of slack notifications sent to this user. Can be either of the following: - Channel name, e.g. “test” - Channel name with # prefix, e.g. “#test” - Channel ID, e.g. “C1234567890” - User ID for DM, e.g. “U1234567890” - Username with @ prefix, e.g. “@test”
to.slackToken object
to.slackToken.access_token string
to.slackToken.app_id string
to.slackToken.authed_user object
to.slackToken.authed_user.access_token string
to.slackToken.authed_user.expires_in number
to.slackToken.authed_user.id string
to.slackToken.authed_user.refresh_token string
to.slackToken.authed_user.scope string
to.slackToken.authed_user.token_type string
to.slackToken.bot_user_id string
to.slackToken.enterprise object
to.slackToken.enterprise.id string
to.slackToken.enterprise.name string
to.slackToken.error string
to.slackToken.expires_in number
to.slackToken.incoming_webhook object
to.slackToken.incoming_webhook.channel string
to.slackToken.incoming_webhook.channel_id string
to.slackToken.incoming_webhook.configuration_url string
to.slackToken.incoming_webhook.url string
to.slackToken.is_enterprise_install boolean
to.slackToken.needed string
to.slackToken.ok boolean (required)
to.slackToken.provided string
to.slackToken.refresh_token string
to.slackToken.scope string
to.slackToken.team object
to.slackToken.team.id string
to.slackToken.team.name string
to.slackToken.token_type string
to.slackToken.warning string
to.slackToken.response_metadata object
to.slackToken.response_metadata.warnings string[]
to.slackToken.response_metadata.next_cursor string
to.slackToken.response_metadata.scopes string[]
to.slackToken.response_metadata.acceptedScopes string[]
to.slackToken.response_metadata.retryAfter number
to.slackToken.response_metadata.messages string[]
to.properties Record<string, string | number | boolean> Custom key-value properties synced by the developer, used for audience segmentation (e.g. broadcast filters on user.properties.plan). Incremental identify calls shallow-merge keys (unset keys are preserved). Limits: max 25 keys, key length <= 64, string values <= 256 chars, serialized size <= 1KB.
to.lastSeenTime string Last activity timestamp. Updated automatically. Read-only.
to.updatedAt string Last update timestamp. Read-only.
to.createdAt string Creation timestamp. Read-only.
to.emailSuppressionStatus object Bounce or complaint status if email was suppressed. Read-only.
to.emailSuppressionStatus.reason “Bounce” | “Complaint” (required)
to.emailSuppressionStatus.details object (required)
forceChannels (“EMAIL” | “INAPP_WEB” | “SMS” | “CALL” | “VOICE” | “PUSH” | “WEB_PUSH” | “SLACK”)[] Override which channels to send to (e.g. [“EMAIL”, “SMS”]). Bypasses notification channel config.
parameters Record<string, any> Key-value pairs for template merge tags. Replaces placeholders like {{firstName}} in templates.
templateId string Specific template ID to use. If omitted, uses the default template for each channel.
subNotificationId string Sub-notification identifier (e.g. for grouping related notifications).
options object Per-channel overrides for send options (email, APN, FCM).
options.email object Email-specific overrides.
options.email.replyToAddresses string[] Reply-to addresses for the email.
options.email.ccAddresses string[] CC recipients.
options.email.bccAddresses string[] BCC recipients.
options.email.fromAddress string Override sender email address.
options.email.fromName string Override sender display name.
options.email.openTracking boolean When false, this send does not record opens and no open pixel is added. Delivery, bounce, and complaint events are unchanged. Defaults to true.
options.email.clickTracking boolean When false, links are left as written and clicks are not recorded. Delivery, bounce, and complaint events are unchanged. Defaults to true.
options.email.attachments (object | object)[] File attachments (by URL or inline base64 content). Inline content: ~4 MB raw per file (413 if exceeded). URL url: up to 20 MB per file.
options.apn object Apple Push Notification (APN) overrides.
options.apn.expiry number Seconds until the notification expires.
options.apn.priority number Delivery priority (10 = immediate, 5 = power-saving).
options.apn.collapseId string Group notifications with the same ID (replaces previous).
options.apn.threadId string Thread identifier for grouping notifications.
options.apn.badge number Badge count on app icon.
options.apn.sound string Sound file name.
options.apn.contentAvailable boolean Silent background notification (no alert).
options.fcm object Firebase Cloud Messaging (FCM) overrides.
options.fcm.android object Android-specific FCM options.
options.fcm.android.collapseKey string Collapse key for grouping messages.
options.fcm.android.priority “high” | “normal” Delivery priority.
options.fcm.android.ttl number Time to live in seconds.
options.fcm.android.restrictedPackageName string Restrict delivery to a specific package.
options.push object Cross-platform mobile push options (applied to both APN and FCM).
options.push.customData Record<string, string> Up to 3 custom string key-value pairs for deep linking. Included in both APN and FCM payloads.
schedule string
email object Inline email content (subject, html). Use when not using templates.
email.subject string (required) Email subject line.
email.html string (required) HTML body content.
email.previewText string Preview/snippet text shown in inbox.
email.senderName string Display name of sender.
email.senderEmail string Sender email address.
inapp object Inline in-app content (title, url, image).
inapp.title string (required) Notification title.
inapp.url string URL to open when clicked.
inapp.image string Image URL.
sms object Inline SMS content (message, from, mediaUrls).
sms.message string SMS/MMS body text.
sms.mediaUrls string[] Public HTTPS URLs of media to attach (MMS). Carriers fetch these via GET. Total size limits apply per provider.
sms.from string Override the sender phone number. Must be a verified number on your account.
call object Inline call content (message).
call.message string (required) Text to speak (TTS).
web_push object Inline web push content (title, message, icon, url).
web_push.title string (required) Notification title.
web_push.message string (required) Body text.
web_push.icon string Icon URL.
web_push.url string URL to open when clicked.
mobile_push object Inline mobile push content (title, message).
mobile_push.title string (required) Notification title.
mobile_push.message string (required) Body text.
slack object Inline Slack content (text, blocks, etc.).
slack.text string (required) Fallback plain text (required when using blocks).
slack.blocks Record<string, any>[] Slack Block Kit blocks.
slack.username string Override bot username.
slack.icon string Icon: emoji (e.g. “:smile:”) or URL. Default: bot’s icon.
slack.thread_ts string Parent message ts to post in a thread.
slack.reply_broadcast boolean When true with thread_ts, broadcasts reply to channel. Default: false.
slack.parse “full” | “none” URL parsing: “full” (clickable links) or “none”. Default: “none”.
slack.link_names boolean Convert channel and username refs to Slack links. Default: false.
slack.mrkdwn boolean Enable Slack markup (bold, italic, code). Default: true.
slack.unfurl_links boolean Unfurl link previews. Default: true.
slack.unfurl_media boolean Unfurl media previews. Default: true.
slack.metadata object Slack message metadata with optional work object entities. Combines standard Slack message metadata fields with an array of entity objects.
slack.metadata.entities object[] An array of work object entities.
slack.metadata.entities[].entity_type string (required) Entity type (e.g., ‘slack#/entities/task’, ‘slack#/entities/file’).
slack.metadata.entities[].entity_payload Record<string, any> (required) Schema for the given entity type.
slack.metadata.entities[].external_ref object (required) Reference used to identify an entity within the developer’s system.
slack.metadata.entities[].external_ref.id string (required)
slack.metadata.entities[].external_ref.type string
slack.metadata.entities[].url string (required) URL used to identify an entity within the developer’s system.
slack.metadata.entities[].app_unfurl_url string The exact URL posted in the source message. Required in metadata passed to chat.unfurl.
slack.metadata.event_type string A human readable alphanumeric string representing your application’s metadata event.
slack.metadata.event_payload Record<string, any> A free-form object containing whatever data your application wishes to attach to messages.

Webhooks

webhooks_create_webhook()

Create a webhook endpoint on a server outside Pingram

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
webhook_endpoint_upsert_request = WebhookEndpointUpsertRequest()
response = await client.webhooks.webhooks_create_webhook(webhook_endpoint_upsert_request)
print(response)

Parameters

Name Type Description Notes
webhook_endpoint_upsert_request WebhookEndpointUpsertRequest See Request Body Properties below

Request Body Properties

Name Type Description
webhook string (required) Public HTTPS URL that accepts POST with a JSON event body. Return 2xx to acknowledge. Private, loopback, and link-local addresses are rejected. Requests include X-Pingram-Id, X-Pingram-Signature (v1 HMAC-SHA256), and X-Pingram-Timestamp. A username and password in this URL are stored separately and removed from the saved URL.
events (“EMAIL_OPEN” | “EMAIL_CLICK” | “EMAIL_FAILED” | “EMAIL_DELIVERED” | “EMAIL_UNSUBSCRIBE” | “EMAIL_INBOUND” | “INAPP_WEB_FAILED” | “INAPP_WEB_UNSUBSCRIBE” | “SMS_DELIVERED” | “SMS_FAILED” | “SMS_UNSUBSCRIBE” | “SMS_SUBSCRIBE” | “SMS_INBOUND” | “VOICE_INBOUND” | “VOICE_CONNECTED” | “VOICE_ENDED” | “PUSH_FAILED” | “PUSH_UNSUBSCRIBE” | “CALL_FAILED” | “CALL_UNSUBSCRIBE” | “WEB_PUSH_FAILED” | “WEB_PUSH_UNSUBSCRIBE” | “SLACK_FAILED” | “SLACK_UNSUBSCRIBE” | “ACCOUNT_USAGE”)[] (required) Full set of event types to deliver to this URL. Omitting an event on update unsubscribes it. Inbound SMS to the free shared number only works when that person has already received a text from this number. Inbound SMS to a dedicated number works normally.
basicAuth object HTTP Basic credentials. Omit to leave stored credentials unchanged. null removes them. Do not also put credentials in the webhook URL. The password is write-only.
basicAuth.username string (required) Username for the Authorization header.
basicAuth.password string Password for the Authorization header. Required when setting basic auth. Omit on update to keep the stored password.

webhooks_delete_webhook()

Delete one webhook endpoint by id from list or create

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
endpoint_id = 'endpoint_id_example'
response = await client.webhooks.webhooks_delete_webhook(endpoint_id)
print(response)

Parameters

Name Type Description Notes
endpoint_id str Id of the webhook endpoint, from list or create.

webhooks_list_webhooks()

List webhook endpoints

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
response = await client.webhooks.webhooks_list_webhooks()
print(response)

Parameters

This endpoint does not need any parameter.

webhooks_update_webhook()

Replace a webhook endpoint

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
endpoint_id = 'endpoint_id_example'
webhook_endpoint_upsert_request = WebhookEndpointUpsertRequest()
response = await client.webhooks.webhooks_update_webhook(endpoint_id, webhook_endpoint_upsert_request)
print(response)

Parameters

Name Type Description Notes
endpoint_id str Id of the webhook endpoint, from list or create.
webhook_endpoint_upsert_request WebhookEndpointUpsertRequest See Request Body Properties below

Request Body Properties

Name Type Description
webhook string (required) Public HTTPS URL that accepts POST with a JSON event body. Return 2xx to acknowledge. Private, loopback, and link-local addresses are rejected. Requests include X-Pingram-Id, X-Pingram-Signature (v1 HMAC-SHA256), and X-Pingram-Timestamp. A username and password in this URL are stored separately and removed from the saved URL.
events (“EMAIL_OPEN” | “EMAIL_CLICK” | “EMAIL_FAILED” | “EMAIL_DELIVERED” | “EMAIL_UNSUBSCRIBE” | “EMAIL_INBOUND” | “INAPP_WEB_FAILED” | “INAPP_WEB_UNSUBSCRIBE” | “SMS_DELIVERED” | “SMS_FAILED” | “SMS_UNSUBSCRIBE” | “SMS_SUBSCRIBE” | “SMS_INBOUND” | “VOICE_INBOUND” | “VOICE_CONNECTED” | “VOICE_ENDED” | “PUSH_FAILED” | “PUSH_UNSUBSCRIBE” | “CALL_FAILED” | “CALL_UNSUBSCRIBE” | “WEB_PUSH_FAILED” | “WEB_PUSH_UNSUBSCRIBE” | “SLACK_FAILED” | “SLACK_UNSUBSCRIBE” | “ACCOUNT_USAGE”)[] (required) Full set of event types to deliver to this URL. Omitting an event on update unsubscribes it. Inbound SMS to the free shared number only works when that person has already received a text from this number. Inbound SMS to a dedicated number works normally.
basicAuth object HTTP Basic credentials. Omit to leave stored credentials unchanged. null removes them. Do not also put credentials in the webhook URL. The password is write-only.
basicAuth.username string (required) Username for the Authorization header.
basicAuth.password string Password for the Authorization header. Required when setting basic auth. Omit on update to keep the stored password.

Accounts

accounts_create_account()

Create another Pingram account

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
create_account_request = CreateAccountRequest()
response = await client.accounts.accounts_create_account(create_account_request)
print(response)

Parameters

Name Type Description Notes
create_account_request CreateAccountRequest See Request Body Properties below

Request Body Properties

Name Type Description
name string (required)
plan object Billing to copy onto a new additional account.
plan.tier “budget_20” | “budget_50” | “budget_100” | “budget_250” | “budget_500” | “budget_1000” (required)
plan.sourceBillingAccountId string (required) Account whose saved payment method is copied onto the new account. The caller must be an owner of this account.
memberEmails string[] Emails to add or invite to the new account. Existing members of any account the caller belongs to are added directly; everyone else is invited.

accounts_list_accounts()

List accounts the authenticated user can access

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
response = await client.accounts.accounts_list_accounts()
print(response)

Parameters

This endpoint does not need any parameter.

accounts_update_account()

Change the display name of an account

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
account_id = 'account_id_example'
update_account_request = UpdateAccountRequest()
response = await client.accounts.accounts_update_account(account_id, update_account_request)
print(response)

Parameters

Name Type Description Notes
account_id str Account to rename
update_account_request UpdateAccountRequest See Request Body Properties below

Request Body Properties

Name Type Description
name string (required) Display name for this account.

Broadcasts

broadcasts_archive()

Archive an email broadcast

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
broadcast_id = 'broadcast_id_example'
response = await client.broadcasts.broadcasts_archive(broadcast_id)
print(response)

Parameters

Name Type Description Notes
broadcast_id str Broadcast ID

broadcasts_cancel()

Cancel an email broadcast

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
broadcast_id = 'broadcast_id_example'
response = await client.broadcasts.broadcasts_cancel(broadcast_id)
print(response)

Parameters

Name Type Description Notes
broadcast_id str Broadcast ID

broadcasts_create()

Create a draft email broadcast

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
create_broadcast_request = CreateBroadcastRequest()
response = await client.broadcasts.broadcasts_create(create_broadcast_request)
print(response)

Parameters

Name Type Description Notes
create_broadcast_request CreateBroadcastRequest See Request Body Properties below

Request Body Properties

Name Type Description
name string (required)
type string Notification type id. Optional on create; required before send/schedule. Created on the fly when missing.
channel “email”
audience object (required) Broadcast audience: exactly one of filter (Mongo-style query evaluated against synced user objects) or emails (raw list, max 10,000 addresses; for larger audiences use filter after syncing users via the Users API).
audience.filter Record<string, any>
audience.emails string[]
fromName string (required)
fromAddress string (required) From address. Use an address on a domain verified for this account to email other people. The shared address noreply@pingram.email can send a test broadcast only to your own account email as the sole recipient. Verify a domain to send to a wider audience.
replyToAddress string
subject string (required)
html string (required)
internalTemplate string Optional visual-editor source. Pair with html. A later update can add it to a draft by sending it with html.

broadcasts_delete()

Delete an email broadcast

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
broadcast_id = 'broadcast_id_example'
response = await client.broadcasts.broadcasts_delete(broadcast_id)
print(response)

Parameters

Name Type Description Notes
broadcast_id str Broadcast ID

broadcasts_get()

Get one email broadcast by ID

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
broadcast_id = 'broadcast_id_example'
response = await client.broadcasts.broadcasts_get(broadcast_id)
print(response)

Parameters

Name Type Description Notes
broadcast_id str Broadcast ID

broadcasts_get_metrics()

Get live broadcast metrics

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
broadcast_id = 'broadcast_id_example'
response = await client.broadcasts.broadcasts_get_metrics(broadcast_id)
print(response)

Parameters

Name Type Description Notes
broadcast_id str Broadcast ID

broadcasts_list()

List email broadcasts for the account, newest first

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
limit = 3.4
next_token = 'next_token_example'
response = await client.broadcasts.broadcasts_list(limit=limit, next_token=next_token)
print(response)

Parameters

Name Type Description Notes
limit float Max broadcasts to return (default 50) [optional]
next_token str Pagination token [optional]

broadcasts_list_recipients()

List email broadcast recipients

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
broadcast_id = 'broadcast_id_example'
status = 'status_example'
limit = 3.4
next_token = 'next_token_example'
response = await client.broadcasts.broadcasts_list_recipients(broadcast_id, status=status, limit=limit, next_token=next_token)
print(response)

Parameters

Name Type Description Notes
broadcast_id str Broadcast ID
status str Filter [optional]
limit float Max recipients to return (default 50) [optional]
next_token str Pagination token [optional]

broadcasts_pause()

Pause an actively sending email broadcast

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
broadcast_id = 'broadcast_id_example'
response = await client.broadcasts.broadcasts_pause(broadcast_id)
print(response)

Parameters

Name Type Description Notes
broadcast_id str Broadcast ID

broadcasts_resume()

Resume a paused email broadcast

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
broadcast_id = 'broadcast_id_example'
response = await client.broadcasts.broadcasts_resume(broadcast_id)
print(response)

Parameters

Name Type Description Notes
broadcast_id str Broadcast ID

broadcasts_schedule()

Schedule a draft email broadcast for a future ISO datetime

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
broadcast_id = 'broadcast_id_example'
schedule_broadcast_request = ScheduleBroadcastRequest()
response = await client.broadcasts.broadcasts_schedule(broadcast_id, schedule_broadcast_request)
print(response)

Parameters

Name Type Description Notes
broadcast_id str Broadcast ID
schedule_broadcast_request ScheduleBroadcastRequest See Request Body Properties below

Request Body Properties

Name Type Description
sendAt string (required) ISO datetime in the future.

broadcasts_send()

Send a draft email broadcast immediately

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
broadcast_id = 'broadcast_id_example'
response = await client.broadcasts.broadcasts_send(broadcast_id)
print(response)

Parameters

Name Type Description Notes
broadcast_id str Broadcast ID

broadcasts_unarchive()

Restore an archived email broadcast

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
broadcast_id = 'broadcast_id_example'
response = await client.broadcasts.broadcasts_unarchive(broadcast_id)
print(response)

Parameters

Name Type Description Notes
broadcast_id str Broadcast ID

broadcasts_update()

Update a draft email broadcast

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
broadcast_id = 'broadcast_id_example'
update_broadcast_request = UpdateBroadcastRequest()
response = await client.broadcasts.broadcasts_update(broadcast_id, update_broadcast_request)
print(response)

Parameters

Name Type Description Notes
broadcast_id str Broadcast ID
update_broadcast_request UpdateBroadcastRequest See Request Body Properties below

Request Body Properties

Name Type Description
name string
type string
channel “email”
audience object Broadcast audience: exactly one of filter (Mongo-style query evaluated against synced user objects) or emails (raw list, max 10,000 addresses; for larger audiences use filter after syncing users via the Users API).
audience.filter Record<string, any>
audience.emails string[]
fromName string
fromAddress string From address. Use an address on a domain verified for this account to email other people. The shared address noreply@pingram.email can send a test broadcast only to your own account email as the sole recipient. Verify a domain to send to a wider audience.
replyToAddress string Omit to leave unchanged. Empty string clears Reply-To.
subject string
html string
internalTemplate string Visual-editor source. Send with html to add it to an html-only draft or to update it. Cannot be removed.

Domains

domains_add_domain()

Start verification for a domain you already own

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
post_senders_request_body = PostSendersRequestBody()
response = await client.domains.domains_add_domain(post_senders_request_body)
print(response)

Parameters

Name Type Description Notes
post_senders_request_body PostSendersRequestBody See Request Body Properties below

Request Body Properties

Name Type Description
sender string (required)

domains_delete_domain()

Remove a sender domain from the account

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
sender = 'sender_example'
response = await client.domains.domains_delete_domain(sender)
print(response)

Parameters

Name Type Description Notes
sender str Sender domain (URL encoded)

domains_list_domains()

List domains already added to this Pingram account for email

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
response = await client.domains.domains_list_domains()
print(response)

Parameters

This endpoint does not need any parameter.

domains_start_domain_verification()

Start domain verification

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
sender = 'sender_example'
response = await client.domains.domains_start_domain_verification(sender)
print(response)

Parameters

Name Type Description Notes
sender str Sender domain (URL encoded)

Email

email_delete_suppressions()

Remove email suppressions

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
reason = 'reason_example'
response = await client.email.email_delete_suppressions(reason)
print(response)

Parameters

Name Type Description Notes
reason str Suppression reason to clear (retryable bounces)

email_send()

Send an email

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
send_email_request = SendEmailRequest()
response = await client.email.email_send(send_email_request)
print(response)

Parameters

Name Type Description Notes
send_email_request SendEmailRequest See Request Body Properties below

Request Body Properties

Name Type Description
type string (required) The notification type to send.
to string (required) The email address of the recipient.
subject string (required) The subject of the email.
html string (required) The HTML body of the email.
fromName string The display name of the sender.
fromAddress string The email address of the sender.
previewText string The preview text of the email.
replyToAddresses string[] The reply-to addresses of the email.
ccAddresses string[] The CC addresses of the email.
bccAddresses string[] The BCC addresses of the email.
openTracking boolean When false, this send does not record opens and no open pixel is added. Delivery, bounce, and complaint events are unchanged. Defaults to true.
clickTracking boolean When false, links are left as written and clicks are not recorded. Delivery, bounce, and complaint events are unchanged. Defaults to true.
attachments object[] URL-based file attachments. Up to 20 MB per file.
attachments[].filename string (required)
attachments[].url string (required)
schedule string The ISO 8601 datetime to schedule the email.

Environments

environments_list_environments()

Get all environments for the authenticated account

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
response = await client.environments.environments_list_environments()
print(response)

Parameters

This endpoint does not need any parameter.

environments_update_environment()

Update environment settings

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
client_id = 'client_id_example'
environment_patch_request = EnvironmentPatchRequest()
response = await client.environments.environments_update_environment(client_id, environment_patch_request)
print(response)

Parameters

Name Type Description Notes
client_id str Environment client ID
environment_patch_request EnvironmentPatchRequest See Request Body Properties below

Request Body Properties

Name Type Description
resetSecret boolean
disableSending (“EMAIL” | “INAPP_WEB” | “SMS” | “CALL” | “VOICE” | “PUSH” | “WEB_PUSH” | “SLACK”)[]
title string
secureMode boolean

Library

library_create()

Create an upload slot in the account library

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
use_case = 'use_case_example'
create_library_request = CreateLibraryRequest()
response = await client.library.library_create(use_case, create_library_request)
print(response)

Parameters

Name Type Description Notes
use_case str Library use-case
create_library_request CreateLibraryRequest See Request Body Properties below

Request Body Properties

Name Type Description
filename string (required) Original filename, including extension (e.g. hero.png).
contentType string (required) Image MIME type. One of image/png, image/jpeg, image/gif, or image/webp.

library_list()

List files in the account library

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
use_case = 'use_case_example'
limit = 3.4
next_token = 'next_token_example'
response = await client.library.library_list(use_case, limit=limit, next_token=next_token)
print(response)

Parameters

Name Type Description Notes
use_case str Library use-case
limit float Max items to return (default 50) [optional]
next_token str Pagination token [optional]

Logs

logs_get_delivery_status()

Look up email and SMS delivery status

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
tracking_ids = 'tracking_ids_example'
response = await client.logs.logs_get_delivery_status(tracking_ids)
print(response)

Parameters

Name Type Description Notes
tracking_ids str Comma-separated tracking IDs (URL encoded, max 25)

logs_get_log_retention()

Get log retention period in days for the account

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
response = await client.logs.logs_get_log_retention()
print(response)

Parameters

This endpoint does not need any parameter.

logs_get_logs()

List recent notification logs

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
limit = 3.4
cursor = 'cursor_example'
response = await client.logs.logs_get_logs(limit=limit, cursor=cursor)
print(response)

Parameters

Name Type Description Notes
limit float Maximum number of logs to return (default [optional]
cursor str Pagination cursor for next page [optional]

logs_get_logs_by_tracking_ids()

Get logs by tracking IDs (comma-separated, max 25 IDs)

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
tracking_ids = 'tracking_ids_example'
response = await client.logs.logs_get_logs_by_tracking_ids(tracking_ids)
print(response)

Parameters

Name Type Description Notes
tracking_ids str Comma-separated tracking IDs (URL encoded)

logs_get_logs_query_result()

Get results from a log query started with Start Log Query

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
query_id = 'query_id_example'
response = await client.logs.logs_get_logs_query_result(query_id)
print(response)

Parameters

Name Type Description Notes
query_id str Query ID returned by Start Log Query

logs_retry_inbound()

Resend the EMAIL_INBOUND webhook for one inbound email

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
tracking_id = 'tracking_id_example'
response = await client.logs.logs_retry_inbound(tracking_id)
print(response)

Parameters

Name Type Description Notes
tracking_id str Tracking ID of the inbound email

logs_start_logs_query()

Start an asynchronous log search over a date range

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
log_query_post_body = LogQueryPostBody()
response = await client.logs.logs_start_logs_query(log_query_post_body)
print(response)

Parameters

Name Type Description Notes
log_query_post_body LogQueryPostBody See Request Body Properties below

Request Body Properties

Name Type Description
dateRangeFilter number[] A tuple of [startTime, endTime] for the date range filter, each representing a unix timestamp.
userFilter string
envIdFilter string[]
statusFilter string
channelFilter (“email” | “inapp” | “sms” | “call” | “voice” | “web_push” | “mobile_push” | “slack”)[]
notificationFilter string[]

logs_tail_logs()

Get last 100 logs from the stream

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
response = await client.logs.logs_tail_logs()
print(response)

Parameters

This endpoint does not need any parameter.

Numbers

numbers_list()

List phone numbers

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
response = await client.numbers.numbers_list()
print(response)

Parameters

This endpoint does not need any parameter.

numbers_list_released()

List released phone numbers

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
response = await client.numbers.numbers_list_released()
print(response)

Parameters

This endpoint does not need any parameter.

numbers_order_number()

Purchase a phone number

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
order_phone_number_request = OrderPhoneNumberRequest()
response = await client.numbers.numbers_order_number(order_phone_number_request)
print(response)

Parameters

Name Type Description Notes
order_phone_number_request OrderPhoneNumberRequest See Request Body Properties below

Request Body Properties

Name Type Description
phoneNumber string (required) E.164 from search results

numbers_release_number()

Release a phone number from the account

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
phone_number = 'phone_number_example'
response = await client.numbers.numbers_release_number(phone_number)
print(response)

Parameters

Name Type Description Notes
phone_number str E.164 phone number to release

Profile

profile_accept_invite()

Accept a team invitation using a token

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
accept_invite_request = AcceptInviteRequest()
response = await client.profile.profile_accept_invite(accept_invite_request)
print(response)

Parameters

Name Type Description Notes
accept_invite_request AcceptInviteRequest See Request Body Properties below

Request Body Properties

Name Type Description
token string (required)

profile_delete_account()

Permanently delete the authenticated user’s account

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
delete_account_request = DeleteAccountRequest()
response = await client.profile.profile_delete_account(delete_account_request)
print(response)

Parameters

Name Type Description Notes
delete_account_request DeleteAccountRequest See Request Body Properties below

Request Body Properties

Name Type Description
reason string

profile_disable_mfa()

Disable MFA for the authenticated user

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
type = 'type_example'
response = await client.profile.profile_disable_mfa(type)
print(response)

Parameters

Name Type Description Notes
type str MFA type (e.g. SOFTWARE_TOKEN_MFA)

profile_get_mfa_status()

Get MFA status for the authenticated user

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
response = await client.profile.profile_get_mfa_status()
print(response)

Parameters

This endpoint does not need any parameter.

profile_setup_mfa()

Start TOTP MFA setup and return QR code data

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
mfa_setup_request = MFASetupRequest()
response = await client.profile.profile_setup_mfa(mfa_setup_request)
print(response)

Parameters

Name Type Description Notes
mfa_setup_request MFASetupRequest See Request Body Properties below

Request Body Properties

Name Type Description
type “SOFTWARE_TOKEN_MFA” (required) MFA methods supported by the profile MFA API.

profile_verify_mfa()

Verify TOTP code and enable MFA

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
mfa_verify_request = MFAVerifyRequest()
response = await client.profile.profile_verify_mfa(mfa_verify_request)
print(response)

Parameters

Name Type Description Notes
mfa_verify_request MFAVerifyRequest See Request Body Properties below

Request Body Properties

Name Type Description
type “SOFTWARE_TOKEN_MFA” (required) MFA methods supported by the profile MFA API.
code string (required)
session string (required)

Registrations

registrations_create_us10dlc_brand()

Create a new 10DLC brand registration

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
ten_dlc_brand_create_request = TenDlcBrandCreateRequest()
response = await client.registrations.registrations_create_us10dlc_brand(ten_dlc_brand_create_request)
print(response)

Parameters

Name Type Description Notes
ten_dlc_brand_create_request TenDlcBrandCreateRequest See Request Body Properties below

Request Body Properties

Name Type Description
scenarioId “own_brand” | “client_brand” (required) Who the 10DLC brand is registered for. - own_brand: personal or company project - client_brand: agency or contractor
businessType “PRIVATE_PROFIT” | “SOLE_PROPRIETOR” | “PUBLIC_PROFIT” | “NON_PROFIT” | “GOVERNMENT” (required) Legal entity type for a 10DLC brand. - PRIVATE_PROFIT: private for-profit (LLC, corp, etc.) - SOLE_PROPRIETOR: sole proprietorship - PUBLIC_PROFIT: publicly traded for-profit - NON_PROFIT: non-profit - GOVERNMENT: government
legalName string Official registered legal business name. For SOLE_PROPRIETOR, optional DBA or trade name (defaults to firstName and lastName).
displayName string (required) Public brand name shown to recipients and carriers. Use the name customers recognize (your DBA or trade name). For companies with no DBA, use the same value as legalName. For SOLE_PROPRIETOR, this is the brand you send as — not the individual’s legal name (set firstName and lastName for that). If the sole proprietor has no DBA, use first and last name.
firstName string Legal first name of the sole proprietor. Required when businessType is SOLE_PROPRIETOR.
lastName string Legal last name of the sole proprietor. Required when businessType is SOLE_PROPRIETOR.
taxId string For US companies (country US): 9-digit EIN (Employer Identification Number). For Canada (country CA): 9-digit BN (Business Number). For other countries: national business tax identifier. Required except when businessType is SOLE_PROPRIETOR.
website string (required) Public website for the brand. Include a scheme (https://) or a domain; https:// is prepended when omitted. Carriers expect a working site with privacy policy and terms.
country string (required) ISO 3166-1 alpha-2 country of incorporation (for example US or CA).
street string (required) Street address that matches official tax registration.
city string (required) City that matches official tax registration.
state string (required) State (US) or province (CA) that matches official tax registration.
postalCode string (required) ZIP code (US) or postal code (CA) that matches official tax registration.
complianceContactEmail string (required) Email for the 10DLC compliance contact. Used for carrier and registration follow-up.
complianceContactPhone string (required) Phone number for the 10DLC compliance contact. E.164 preferred; national numbers are normalized using country.

registrations_get_us10dlc_brand()

Get the 10DLC brand registration

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
response = await client.registrations.registrations_get_us10dlc_brand()
print(response)

Parameters

This endpoint does not need any parameter.

registrations_get_us10dlc_campaign()

Get the 10DLC campaign registration

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
response = await client.registrations.registrations_get_us10dlc_campaign()
print(response)

Parameters

This endpoint does not need any parameter.

registrations_update_us10dlc_brand()

Update the 10DLC brand

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
ten_dlc_brand_update_request = TenDlcBrandUpdateRequest()
response = await client.registrations.registrations_update_us10dlc_brand(ten_dlc_brand_update_request)
print(response)

Parameters

Name Type Description Notes
ten_dlc_brand_update_request TenDlcBrandUpdateRequest See Request Body Properties below

Request Body Properties

Name Type Description
scenarioId “own_brand” | “client_brand” Who the 10DLC brand is registered for. - own_brand: personal or company project - client_brand: agency or contractor
businessType “PRIVATE_PROFIT” | “SOLE_PROPRIETOR” | “PUBLIC_PROFIT” | “NON_PROFIT” | “GOVERNMENT” Legal entity type for a 10DLC brand. - PRIVATE_PROFIT: private for-profit (LLC, corp, etc.) - SOLE_PROPRIETOR: sole proprietorship - PUBLIC_PROFIT: publicly traded for-profit - NON_PROFIT: non-profit - GOVERNMENT: government
legalName string Official registered legal business name. For SOLE_PROPRIETOR, optional DBA or trade name (defaults to firstName and lastName).
displayName string Public brand name shown to recipients and carriers. Use the name customers recognize (your DBA or trade name). For SOLE_PROPRIETOR, this is the brand you send as — not the individual’s legal name. Omit to keep the existing value. If you change legalName and omit displayName, displayName is reset to the new legalName.
firstName string Legal first name of the sole proprietor. Required when businessType is SOLE_PROPRIETOR.
lastName string Legal last name of the sole proprietor. Required when businessType is SOLE_PROPRIETOR.
taxId string For US companies (country US): 9-digit EIN (Employer Identification Number). For Canada (country CA): 9-digit BN (Business Number). For other countries: national business tax identifier. Required except when businessType is SOLE_PROPRIETOR.
website string Public website for the brand. Include a scheme (https://) or a domain; https:// is prepended when omitted. Carriers expect a working site with privacy policy and terms.
country string ISO 3166-1 alpha-2 country of incorporation (for example US or CA).
street string Street address that matches official tax registration.
city string City that matches official tax registration.
state string State (US) or province (CA) that matches official tax registration.
postalCode string ZIP code (US) or postal code (CA) that matches official tax registration.
complianceContactEmail string Email for the 10DLC compliance contact. Used for carrier and registration follow-up.
complianceContactPhone string Phone number for the 10DLC compliance contact. E.164 preferred; national numbers are normalized using country.

registrations_update_us10dlc_campaign()

Update the 10DLC campaign

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
ten_dlc_campaign_update_request = TenDlcCampaignUpdateRequest()
response = await client.registrations.registrations_update_us10dlc_campaign(ten_dlc_campaign_update_request)
print(response)

Parameters

Name Type Description Notes
ten_dlc_campaign_update_request TenDlcCampaignUpdateRequest See Request Body Properties below

Request Body Properties

Name Type Description
campaignDescription string Summary of what this campaign sends and why, including audience and typical message content. Required before carrier submission.
campaignSample1 string Example SMS that represents actual campaign traffic. Required before carrier submission. Should match the use case and typically identify the brand and include STOP/HELP language.
campaignSample2 string Second example SMS. Required before carrier submission. Required for MARKETING and MIXED use cases.
campaignSample3 string Optional third example SMS.
campaignSample4 string Optional fourth example SMS.
campaignMessageFlow string How recipients opt in (for example website form, checkout, or keyword). Describe the call-to-action and where consent is collected. Required before carrier submission.
campaignOptinKeywords string Extra opt-in keywords as a comma-separated list. START is always included.
campaignOptinMessage string Auto-reply sent when a recipient opts in. Required before carrier submission. Should confirm the subscription, mention message frequency, and include STOP and HELP instructions.
campaignOptoutKeywords string Extra opt-out keywords as a comma-separated list. STOP is always included.
campaignOptoutMessage string Auto-reply sent when a recipient opts out. Required before carrier submission. Should confirm they will receive no further messages.
campaignHelpKeywords string Extra help keywords as a comma-separated list. HELP is always included.
campaignHelpMessage string Auto-reply sent when a recipient texts a help keyword. Required before carrier submission. Should include a support contact (email and/or phone).
campaignEmbeddedLink boolean Whether campaign messages include URLs.
campaignEmbeddedLinkUrl string Sample URL that appears in messages. Provide when campaignEmbeddedLink is true.
campaignEmbeddedPhone boolean Whether campaign messages include phone numbers.
campaignAgeGated boolean Whether campaign content is age-restricted (18+).
campaignDirectLending boolean Whether the campaign relates to direct lending or loan products.
campaignPrivacyPolicyLink string Public URL of the privacy policy that covers this SMS program.
campaignTermsAndConditionsLink string Public URL of the terms and conditions that cover this SMS program.
campaignUsecase string 10DLC campaign use case submitted to carriers. Required before carrier submission. One of 2FA, ACCOUNT_NOTIFICATION, CUSTOMER_CARE, DELIVERY_NOTIFICATION, FRAUD_ALERT, MARKETING, MIXED, POLLING_VOTING, PUBLIC_SERVICE_ANNOUNCEMENT, or SECURITY_ALERT. For MIXED, append comma-separated sub-use cases after MIXED (sub-use cases cannot include MIXED), for example MIXED,2FA,ACCOUNT_NOTIFICATION.

Sender

sender_delete_schedule()

Delete (unschedule) an already scheduled notification

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
tracking_id = 'tracking_id_example'
response = await client.sender.sender_delete_schedule(tracking_id)
print(response)

Parameters

Name Type Description Notes
tracking_id str The tracking ID of the scheduled notification

sender_test_email()

Test the emailer with a sample email

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
post_email_test_request = PostEmailTestRequest()
response = await client.sender.sender_test_email(post_email_test_request)
print(response)

Parameters

Name Type Description Notes
post_email_test_request PostEmailTestRequest See Request Body Properties below

Request Body Properties

Name Type Description
notificationId string (required)
to string (required)
subject string (required)
html string (required)
fromAddress string (required)
fromName string (required)
previewText string

sender_update_schedule()

Update a scheduled notification

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
tracking_id = 'tracking_id_example'
sender_post_body = SenderPostBody()
response = await client.sender.sender_update_schedule(tracking_id, sender_post_body)
print(response)

Parameters

Name Type Description Notes
tracking_id str The tracking ID of the scheduled notification
sender_post_body SenderPostBody See Request Body Properties below

Request Body Properties

Name Type Description
type string ID of the notification type (e.g. “welcome_email”). Creates a new notification if it does not exist.
to object Recipient user. Provide id, email, or number to identify the user.
to.id string Unique user identifier. Required.
to.email string User’s email address for email notifications.
to.number string User’s phone number for SMS/call notifications.
to.pushTokens object[] Mobile push tokens (FCM, APN) for push notifications.
to.pushTokens[].type “FCM” | “APN” (required)
to.pushTokens[].token string (required)
to.pushTokens[].device object (required)
to.pushTokens[].device.app_id string
to.pushTokens[].device.ad_id string
to.pushTokens[].device.device_id string (required)
to.pushTokens[].device.platform string
to.pushTokens[].device.manufacturer string
to.pushTokens[].device.model string
to.pushTokens[].environment string used by APN to differentiate between sandbox and production builds (sandbox/undefined or production)
to.webPushTokens object[] Web push subscription config from the browser.
to.webPushTokens[].sub object (required) Configuration for a Push Subscription. This can be obtained on the frontend by calling serviceWorkerRegistration.pushManager.subscribe(). The expected format is the same output as JSON.stringify’ing a PushSubscription in the browser.
to.webPushTokens[].sub.endpoint string (required)
to.webPushTokens[].sub.keys object (required)
to.webPushTokens[].sub.keys.p256dh string (required)
to.webPushTokens[].sub.keys.auth string (required)
to.timezone string User’s timezone (e.g. “America/New_York”) for scheduling.
to.slackChannel string The destination channel of slack notifications sent to this user. Can be either of the following: - Channel name, e.g. “test” - Channel name with # prefix, e.g. “#test” - Channel ID, e.g. “C1234567890” - User ID for DM, e.g. “U1234567890” - Username with @ prefix, e.g. “@test”
to.slackToken object
to.slackToken.access_token string
to.slackToken.app_id string
to.slackToken.authed_user object
to.slackToken.authed_user.access_token string
to.slackToken.authed_user.expires_in number
to.slackToken.authed_user.id string
to.slackToken.authed_user.refresh_token string
to.slackToken.authed_user.scope string
to.slackToken.authed_user.token_type string
to.slackToken.bot_user_id string
to.slackToken.enterprise object
to.slackToken.enterprise.id string
to.slackToken.enterprise.name string
to.slackToken.error string
to.slackToken.expires_in number
to.slackToken.incoming_webhook object
to.slackToken.incoming_webhook.channel string
to.slackToken.incoming_webhook.channel_id string
to.slackToken.incoming_webhook.configuration_url string
to.slackToken.incoming_webhook.url string
to.slackToken.is_enterprise_install boolean
to.slackToken.needed string
to.slackToken.ok boolean (required)
to.slackToken.provided string
to.slackToken.refresh_token string
to.slackToken.scope string
to.slackToken.team object
to.slackToken.team.id string
to.slackToken.team.name string
to.slackToken.token_type string
to.slackToken.warning string
to.slackToken.response_metadata object
to.slackToken.response_metadata.warnings string[]
to.slackToken.response_metadata.next_cursor string
to.slackToken.response_metadata.scopes string[]
to.slackToken.response_metadata.acceptedScopes string[]
to.slackToken.response_metadata.retryAfter number
to.slackToken.response_metadata.messages string[]
to.properties Record<string, string | number | boolean> Custom key-value properties synced by the developer, used for audience segmentation (e.g. broadcast filters on user.properties.plan). Incremental identify calls shallow-merge keys (unset keys are preserved). Limits: max 25 keys, key length <= 64, string values <= 256 chars, serialized size <= 1KB.
to.lastSeenTime string Last activity timestamp. Updated automatically. Read-only.
to.updatedAt string Last update timestamp. Read-only.
to.createdAt string Creation timestamp. Read-only.
to.emailSuppressionStatus object Bounce or complaint status if email was suppressed. Read-only.
to.emailSuppressionStatus.reason “Bounce” | “Complaint” (required)
to.emailSuppressionStatus.details object (required)
forceChannels (“EMAIL” | “INAPP_WEB” | “SMS” | “CALL” | “VOICE” | “PUSH” | “WEB_PUSH” | “SLACK”)[] Override which channels to send to (e.g. [“EMAIL”, “SMS”]). Bypasses notification channel config.
parameters Record<string, any> Key-value pairs for template merge tags. Replaces placeholders like {{firstName}} in templates.
templateId string Specific template ID to use. If omitted, uses the default template for each channel.
subNotificationId string Sub-notification identifier (e.g. for grouping related notifications).
options object Per-channel overrides for send options (email, APN, FCM).
options.email object Email-specific overrides.
options.email.replyToAddresses string[] Reply-to addresses for the email.
options.email.ccAddresses string[] CC recipients.
options.email.bccAddresses string[] BCC recipients.
options.email.fromAddress string Override sender email address.
options.email.fromName string Override sender display name.
options.email.openTracking boolean When false, this send does not record opens and no open pixel is added. Delivery, bounce, and complaint events are unchanged. Defaults to true.
options.email.clickTracking boolean When false, links are left as written and clicks are not recorded. Delivery, bounce, and complaint events are unchanged. Defaults to true.
options.email.attachments (object | object)[] File attachments (by URL or inline base64 content). Inline content: ~4 MB raw per file (413 if exceeded). URL url: up to 20 MB per file.
options.apn object Apple Push Notification (APN) overrides.
options.apn.expiry number Seconds until the notification expires.
options.apn.priority number Delivery priority (10 = immediate, 5 = power-saving).
options.apn.collapseId string Group notifications with the same ID (replaces previous).
options.apn.threadId string Thread identifier for grouping notifications.
options.apn.badge number Badge count on app icon.
options.apn.sound string Sound file name.
options.apn.contentAvailable boolean Silent background notification (no alert).
options.fcm object Firebase Cloud Messaging (FCM) overrides.
options.fcm.android object Android-specific FCM options.
options.fcm.android.collapseKey string Collapse key for grouping messages.
options.fcm.android.priority “high” | “normal” Delivery priority.
options.fcm.android.ttl number Time to live in seconds.
options.fcm.android.restrictedPackageName string Restrict delivery to a specific package.
options.push object Cross-platform mobile push options (applied to both APN and FCM).
options.push.customData Record<string, string> Up to 3 custom string key-value pairs for deep linking. Included in both APN and FCM payloads.
schedule string
email object Inline email content (subject, html). Use when not using templates.
email.subject string (required) Email subject line.
email.html string (required) HTML body content.
email.previewText string Preview/snippet text shown in inbox.
email.senderName string Display name of sender.
email.senderEmail string Sender email address.
inapp object Inline in-app content (title, url, image).
inapp.title string (required) Notification title.
inapp.url string URL to open when clicked.
inapp.image string Image URL.
sms object Inline SMS content (message, from, mediaUrls).
sms.message string SMS/MMS body text.
sms.mediaUrls string[] Public HTTPS URLs of media to attach (MMS). Carriers fetch these via GET. Total size limits apply per provider.
sms.from string Override the sender phone number. Must be a verified number on your account.
call object Inline call content (message).
call.message string (required) Text to speak (TTS).
web_push object Inline web push content (title, message, icon, url).
web_push.title string (required) Notification title.
web_push.message string (required) Body text.
web_push.icon string Icon URL.
web_push.url string URL to open when clicked.
mobile_push object Inline mobile push content (title, message).
mobile_push.title string (required) Notification title.
mobile_push.message string (required) Body text.
slack object Inline Slack content (text, blocks, etc.).
slack.text string (required) Fallback plain text (required when using blocks).
slack.blocks Record<string, any>[] Slack Block Kit blocks.
slack.username string Override bot username.
slack.icon string Icon: emoji (e.g. “:smile:”) or URL. Default: bot’s icon.
slack.thread_ts string Parent message ts to post in a thread.
slack.reply_broadcast boolean When true with thread_ts, broadcasts reply to channel. Default: false.
slack.parse “full” | “none” URL parsing: “full” (clickable links) or “none”. Default: “none”.
slack.link_names boolean Convert channel and username refs to Slack links. Default: false.
slack.mrkdwn boolean Enable Slack markup (bold, italic, code). Default: true.
slack.unfurl_links boolean Unfurl link previews. Default: true.
slack.unfurl_media boolean Unfurl media previews. Default: true.
slack.metadata object Slack message metadata with optional work object entities. Combines standard Slack message metadata fields with an array of entity objects.
slack.metadata.entities object[] An array of work object entities.
slack.metadata.entities[].entity_type string (required) Entity type (e.g., ‘slack#/entities/task’, ‘slack#/entities/file’).
slack.metadata.entities[].entity_payload Record<string, any> (required) Schema for the given entity type.
slack.metadata.entities[].external_ref object (required) Reference used to identify an entity within the developer’s system.
slack.metadata.entities[].external_ref.id string (required)
slack.metadata.entities[].external_ref.type string
slack.metadata.entities[].url string (required) URL used to identify an entity within the developer’s system.
slack.metadata.entities[].app_unfurl_url string The exact URL posted in the source message. Required in metadata passed to chat.unfurl.
slack.metadata.event_type string A human readable alphanumeric string representing your application’s metadata event.
slack.metadata.event_payload Record<string, any> A free-form object containing whatever data your application wishes to attach to messages.

Sms

sms_send()

Send an SMS or MMS directly without a template

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
send_sms_request = SendSmsRequest()
response = await client.sms.sms_send(send_sms_request)
print(response)

Parameters

Name Type Description Notes
send_sms_request SendSmsRequest See Request Body Properties below

Request Body Properties

Name Type Description
type string (required) The notification type to send.
to string (required) The phone number of the recipient.
message string The message of the SMS or MMS notification. Optional when mediaUrls is provided.
mediaUrls string[] Public HTTPS URLs of media to attach (MMS).
schedule string The ISO 8601 datetime to schedule the SMS notification.
from string Override the sender phone number. Must be a dedicated number on your Pingram account.

SubNotifications

sub_notifications_delete_sub_notification()

This endpoint is no longer maintained and should not be used

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
notification_id = 'notification_id_example'
sub_notification_id = 'sub_notification_id_example'
response = await client.sub_notifications.sub_notifications_delete_sub_notification(notification_id, sub_notification_id)
print(response)

Parameters

Name Type Description Notes
notification_id str The notification ID
sub_notification_id str The sub-notification ID

sub_notifications_put_sub_notification()

This endpoint is no longer maintained and should not be used

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
notification_id = 'notification_id_example'
sub_notification_id = 'sub_notification_id_example'
sub_notification_put_request = SubNotificationPUTRequest()
response = await client.sub_notifications.sub_notifications_put_sub_notification(notification_id, sub_notification_id, sub_notification_put_request)
print(response)

Parameters

Name Type Description Notes
notification_id str The notification ID
sub_notification_id str The sub-notification ID
sub_notification_put_request SubNotificationPUTRequest See Request Body Properties below

Request Body Properties

Name Type Description
title string (required)

Templates

templates_create_template()

Create a new template for a notification

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
notification_id = 'notification_id_example'
channel = 'channel_example'
template_post_request = TemplatePostRequest()
response = await client.templates.templates_create_template(notification_id, channel, template_post_request)
print(response)

Parameters

Name Type Description Notes
notification_id str Notification ID
channel str Channel type
template_post_request TemplatePostRequest See Request Body Properties below

Request Body Properties

Name Type Description
templateId string (required) Unique ID for this template within the notification and channel. Required.
html string HTML body of the email.
previewText string Preview text (e.g. for inbox).
internal string Internal editor representation of the email content (e.g. Bee or Redactor JSON). Used for editing and component embedding; the actual email sent to recipients uses the html field.
subject string Email subject line.
senderName string Sender display name.
senderEmail string Sender email address.
title string Notification title (in-app).
redirectURL string URL to open when the user taps the notification.
imageURL string Image URL shown in the in-app notification.
instant object Copy for instant (real-time) delivery.
instant.title string
instant.redirectURL string
instant.imageURL string (required)
batch object Copy for batch delivery.
batch.title string (required)
batch.redirectURL string (required)
batch.imageURL string (required)
text string Message text (SMS or call).
message string Push notification body text. (title is shared with INAPP_WEB above.)
icon string Web push: icon URL. Slack: bot icon (emoji or URL).
url string Web push: URL to open when the notification is clicked.
blocks Record<string, any>[] Slack message blocks (optional).
username string Slack bot username.

templates_delete_template()

Delete a template

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
notification_id = 'notification_id_example'
channel = 'channel_example'
template_id = 'template_id_example'
response = await client.templates.templates_delete_template(notification_id, channel, template_id)
print(response)

Parameters

Name Type Description Notes
notification_id str Notification ID
channel str Channel type
template_id str Template ID

templates_get_template()

Get a single template by ID

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
notification_id = 'notification_id_example'
channel = 'channel_example'
template_id = 'template_id_example'
response = await client.templates.templates_get_template(notification_id, channel, template_id)
print(response)

Parameters

Name Type Description Notes
notification_id str Notification ID
channel str Channel type
template_id str Template ID

templates_list_templates()

List all templates for a notification and channel

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
notification_id = 'notification_id_example'
channel = 'channel_example'
response = await client.templates.templates_list_templates(notification_id, channel)
print(response)

Parameters

Name Type Description Notes
notification_id str Notification ID
channel str Channel type

templates_set_default_template()

Set a template as default for specific delivery modes

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
notification_id = 'notification_id_example'
channel = 'channel_example'
set_default_template_request = SetDefaultTemplateRequest()
response = await client.templates.templates_set_default_template(notification_id, channel, set_default_template_request)
print(response)

Parameters

Name Type Description Notes
notification_id str Notification ID
channel str Channel type
set_default_template_request SetDefaultTemplateRequest See Request Body Properties below

Request Body Properties

Name Type Description
templateId string (required)
modes (“instant” | “hourly” | “daily” | “weekly” | “monthly”)[] (required)

templates_update_template()

Update a template’s properties

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
notification_id = 'notification_id_example'
channel = 'channel_example'
template_id = 'template_id_example'
template_patch_request = TemplatePatchRequest()
response = await client.templates.templates_update_template(notification_id, channel, template_id, template_patch_request)
print(response)

Parameters

Name Type Description Notes
notification_id str Notification ID
channel str Channel type
template_id str Template ID
template_patch_request TemplatePatchRequest See Request Body Properties below

Request Body Properties

Name Type Description
html string HTML body of the email.
previewText string Preview text (e.g. for inbox).
internal string Internal editor representation of the email content (e.g. Bee or Redactor JSON). Used for editing and component embedding; the actual email sent to recipients uses the html field.
subject string Email subject line.
senderName string Sender display name.
senderEmail string Sender email address.
title string Notification title (in-app).
redirectURL string URL to open when the user taps the notification.
imageURL string Image URL shown in the in-app notification.
instant object Copy for instant (real-time) delivery.
instant.title string
instant.redirectURL string
instant.imageURL string (required)
batch object Copy for batch delivery.
batch.title string (required)
batch.redirectURL string (required)
batch.imageURL string (required)
text string Message text (SMS or call).
message string Push notification body text. (title is shared with INAPP_WEB above.)
icon string Web push: icon URL. Slack: bot icon (emoji or URL).
url string Web push: URL to open when the notification is clicked.
blocks Record<string, any>[] Slack message blocks (optional).
username string Slack bot username.

Types

types_create_notification_type()

Create a new notification

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
notification_create_request = NotificationCreateRequest()
response = await client.types.types_create_notification_type(notification_create_request)
print(response)

Parameters

Name Type Description Notes
notification_create_request NotificationCreateRequest See Request Body Properties below

Request Body Properties

Name Type Description
notificationId string (required)
title string (required)
channels string[] (required)
options object
options.EMAIL object
options.EMAIL.defaultDeliveryOption “off” | “instant” | “hourly” | “daily” | “weekly” | “monthly” (required)
options.EMAIL.off object
options.EMAIL.off.enabled boolean (required)
options.EMAIL.instant object
options.EMAIL.instant.enabled boolean (required)
options.EMAIL.hourly object
options.EMAIL.hourly.enabled boolean (required)
options.EMAIL.daily object
options.EMAIL.daily.enabled boolean (required)
options.EMAIL.daily.hour string
options.EMAIL.weekly object
options.EMAIL.weekly.enabled boolean (required)
options.EMAIL.weekly.hour string
options.EMAIL.weekly.day string
options.EMAIL.monthly object
options.EMAIL.monthly.enabled boolean (required)
options.EMAIL.monthly.hour string
options.EMAIL.monthly.date “first” | “last”
options.INAPP_WEB object
options.INAPP_WEB.defaultDeliveryOption “off” | “instant” (required)
options.INAPP_WEB.off object
options.INAPP_WEB.off.enabled boolean (required)
options.INAPP_WEB.instant object
options.INAPP_WEB.instant.enabled boolean (required)
options.INAPP_WEB.instant.batching boolean
options.INAPP_WEB.instant.batchingKey string
options.INAPP_WEB.instant.batchingWindow number
options.SMS object
options.SMS.defaultDeliveryOption “off” | “instant” | “hourly” | “daily” | “weekly” | “monthly” (required)
options.SMS.off object
options.SMS.off.enabled boolean (required)
options.SMS.instant object
options.SMS.instant.enabled boolean (required)
options.SMS.hourly object
options.SMS.hourly.enabled boolean (required)
options.SMS.daily object
options.SMS.daily.enabled boolean (required)
options.SMS.daily.hour string
options.SMS.weekly object
options.SMS.weekly.enabled boolean (required)
options.SMS.weekly.hour string
options.SMS.weekly.day string
options.SMS.monthly object
options.SMS.monthly.enabled boolean (required)
options.SMS.monthly.hour string
options.SMS.monthly.date “first” | “last”
options.CALL object
options.CALL.defaultDeliveryOption “off” | “instant” | “hourly” | “daily” | “weekly” | “monthly” (required)
options.CALL.off object
options.CALL.off.enabled boolean (required)
options.CALL.instant object
options.CALL.instant.enabled boolean (required)
options.CALL.hourly object
options.CALL.hourly.enabled boolean (required)
options.CALL.daily object
options.CALL.daily.enabled boolean (required)
options.CALL.daily.hour string
options.CALL.weekly object
options.CALL.weekly.enabled boolean (required)
options.CALL.weekly.hour string
options.CALL.weekly.day string
options.CALL.monthly object
options.CALL.monthly.enabled boolean (required)
options.CALL.monthly.hour string
options.CALL.monthly.date “first” | “last”
options.VOICE object
options.VOICE.defaultDeliveryOption “off” | “instant” | “hourly” | “daily” | “weekly” | “monthly” (required)
options.VOICE.off object
options.VOICE.off.enabled boolean (required)
options.VOICE.instant object
options.VOICE.instant.enabled boolean (required)
options.VOICE.hourly object
options.VOICE.hourly.enabled boolean (required)
options.VOICE.daily object
options.VOICE.daily.enabled boolean (required)
options.VOICE.daily.hour string
options.VOICE.weekly object
options.VOICE.weekly.enabled boolean (required)
options.VOICE.weekly.hour string
options.VOICE.weekly.day string
options.VOICE.monthly object
options.VOICE.monthly.enabled boolean (required)
options.VOICE.monthly.hour string
options.VOICE.monthly.date “first” | “last”
options.PUSH object
options.PUSH.defaultDeliveryOption “off” | “instant” | “hourly” | “daily” | “weekly” | “monthly” (required)
options.PUSH.off object
options.PUSH.off.enabled boolean (required)
options.PUSH.instant object
options.PUSH.instant.enabled boolean (required)
options.PUSH.hourly object
options.PUSH.hourly.enabled boolean (required)
options.PUSH.daily object
options.PUSH.daily.enabled boolean (required)
options.PUSH.daily.hour string
options.PUSH.weekly object
options.PUSH.weekly.enabled boolean (required)
options.PUSH.weekly.hour string
options.PUSH.weekly.day string
options.PUSH.monthly object
options.PUSH.monthly.enabled boolean (required)
options.PUSH.monthly.hour string
options.PUSH.monthly.date “first” | “last”
options.WEB_PUSH object
options.WEB_PUSH.defaultDeliveryOption “off” | “instant” | “hourly” | “daily” | “weekly” | “monthly” (required)
options.WEB_PUSH.off object
options.WEB_PUSH.off.enabled boolean (required)
options.WEB_PUSH.instant object
options.WEB_PUSH.instant.enabled boolean (required)
options.WEB_PUSH.hourly object
options.WEB_PUSH.hourly.enabled boolean (required)
options.WEB_PUSH.daily object
options.WEB_PUSH.daily.enabled boolean (required)
options.WEB_PUSH.daily.hour string
options.WEB_PUSH.weekly object
options.WEB_PUSH.weekly.enabled boolean (required)
options.WEB_PUSH.weekly.hour string
options.WEB_PUSH.weekly.day string
options.WEB_PUSH.monthly object
options.WEB_PUSH.monthly.enabled boolean (required)
options.WEB_PUSH.monthly.hour string
options.WEB_PUSH.monthly.date “first” | “last”
options.SLACK object
options.SLACK.defaultDeliveryOption “off” | “instant” | “hourly” | “daily” | “weekly” | “monthly” (required)
options.SLACK.off object
options.SLACK.off.enabled boolean (required)
options.SLACK.instant object
options.SLACK.instant.enabled boolean (required)
options.SLACK.hourly object
options.SLACK.hourly.enabled boolean (required)
options.SLACK.daily object
options.SLACK.daily.enabled boolean (required)
options.SLACK.daily.hour string
options.SLACK.weekly object
options.SLACK.weekly.enabled boolean (required)
options.SLACK.weekly.hour string
options.SLACK.weekly.day string
options.SLACK.monthly object
options.SLACK.monthly.enabled boolean (required)
options.SLACK.monthly.hour string
options.SLACK.monthly.date “first” | “last”

types_delete_notification_type()

Delete a notification

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
notification_id = 'notification_id_example'
response = await client.types.types_delete_notification_type(notification_id)
print(response)

Parameters

Name Type Description Notes
notification_id str The notification ID

types_get_notification_type()

Get a specific notification by ID

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
notification_id = 'notification_id_example'
response = await client.types.types_get_notification_type(notification_id)
print(response)

Parameters

Name Type Description Notes
notification_id str The notification ID

types_list_notification_types()

Get all notifications for an account with their templates

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
response = await client.types.types_list_notification_types()
print(response)

Parameters

This endpoint does not need any parameter.

types_update_notification_type()

Update a notification’s settings

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
notification_id = 'notification_id_example'
notification_patch_request = NotificationPatchRequest()
response = await client.types.types_update_notification_type(notification_id, notification_patch_request)
print(response)

Parameters

Name Type Description Notes
notification_id str The notification ID
notification_patch_request NotificationPatchRequest See Request Body Properties below

Request Body Properties

Name Type Description
title string
channels (“EMAIL” | “INAPP_WEB” | “SMS” | “CALL” | “VOICE” | “PUSH” | “WEB_PUSH” | “SLACK”)[]
enabled boolean
deduplication object
deduplication.duration number (required)
throttling object
throttling.max number (required)
throttling.period number (required)
throttling.unit “seconds” | “minutes” | “hours” | “days” | “months” | “years” (required)
throttling.forever boolean (required)
throttling.scope (“userId” | “notificationId”)[] (required)
retention number null
options object
options.EMAIL object
options.EMAIL.defaultDeliveryOption “off” | “instant” | “hourly” | “daily” | “weekly” | “monthly” (required)
options.EMAIL.off object
options.EMAIL.off.enabled boolean (required)
options.EMAIL.instant object
options.EMAIL.instant.enabled boolean (required)
options.EMAIL.hourly object
options.EMAIL.hourly.enabled boolean (required)
options.EMAIL.daily object
options.EMAIL.daily.enabled boolean (required)
options.EMAIL.daily.hour string
options.EMAIL.weekly object
options.EMAIL.weekly.enabled boolean (required)
options.EMAIL.weekly.hour string
options.EMAIL.weekly.day string
options.EMAIL.monthly object
options.EMAIL.monthly.enabled boolean (required)
options.EMAIL.monthly.hour string
options.EMAIL.monthly.date “first” | “last”
options.INAPP_WEB object
options.INAPP_WEB.defaultDeliveryOption “off” | “instant” (required)
options.INAPP_WEB.off object
options.INAPP_WEB.off.enabled boolean (required)
options.INAPP_WEB.instant object
options.INAPP_WEB.instant.enabled boolean (required)
options.INAPP_WEB.instant.batching boolean
options.INAPP_WEB.instant.batchingKey string
options.INAPP_WEB.instant.batchingWindow number
options.SMS object
options.SMS.defaultDeliveryOption “off” | “instant” | “hourly” | “daily” | “weekly” | “monthly” (required)
options.SMS.off object
options.SMS.off.enabled boolean (required)
options.SMS.instant object
options.SMS.instant.enabled boolean (required)
options.SMS.hourly object
options.SMS.hourly.enabled boolean (required)
options.SMS.daily object
options.SMS.daily.enabled boolean (required)
options.SMS.daily.hour string
options.SMS.weekly object
options.SMS.weekly.enabled boolean (required)
options.SMS.weekly.hour string
options.SMS.weekly.day string
options.SMS.monthly object
options.SMS.monthly.enabled boolean (required)
options.SMS.monthly.hour string
options.SMS.monthly.date “first” | “last”
options.CALL object
options.CALL.defaultDeliveryOption “off” | “instant” | “hourly” | “daily” | “weekly” | “monthly” (required)
options.CALL.off object
options.CALL.off.enabled boolean (required)
options.CALL.instant object
options.CALL.instant.enabled boolean (required)
options.CALL.hourly object
options.CALL.hourly.enabled boolean (required)
options.CALL.daily object
options.CALL.daily.enabled boolean (required)
options.CALL.daily.hour string
options.CALL.weekly object
options.CALL.weekly.enabled boolean (required)
options.CALL.weekly.hour string
options.CALL.weekly.day string
options.CALL.monthly object
options.CALL.monthly.enabled boolean (required)
options.CALL.monthly.hour string
options.CALL.monthly.date “first” | “last”
options.VOICE object
options.VOICE.defaultDeliveryOption “off” | “instant” | “hourly” | “daily” | “weekly” | “monthly” (required)
options.VOICE.off object
options.VOICE.off.enabled boolean (required)
options.VOICE.instant object
options.VOICE.instant.enabled boolean (required)
options.VOICE.hourly object
options.VOICE.hourly.enabled boolean (required)
options.VOICE.daily object
options.VOICE.daily.enabled boolean (required)
options.VOICE.daily.hour string
options.VOICE.weekly object
options.VOICE.weekly.enabled boolean (required)
options.VOICE.weekly.hour string
options.VOICE.weekly.day string
options.VOICE.monthly object
options.VOICE.monthly.enabled boolean (required)
options.VOICE.monthly.hour string
options.VOICE.monthly.date “first” | “last”
options.PUSH object
options.PUSH.defaultDeliveryOption “off” | “instant” | “hourly” | “daily” | “weekly” | “monthly” (required)
options.PUSH.off object
options.PUSH.off.enabled boolean (required)
options.PUSH.instant object
options.PUSH.instant.enabled boolean (required)
options.PUSH.hourly object
options.PUSH.hourly.enabled boolean (required)
options.PUSH.daily object
options.PUSH.daily.enabled boolean (required)
options.PUSH.daily.hour string
options.PUSH.weekly object
options.PUSH.weekly.enabled boolean (required)
options.PUSH.weekly.hour string
options.PUSH.weekly.day string
options.PUSH.monthly object
options.PUSH.monthly.enabled boolean (required)
options.PUSH.monthly.hour string
options.PUSH.monthly.date “first” | “last”
options.WEB_PUSH object
options.WEB_PUSH.defaultDeliveryOption “off” | “instant” | “hourly” | “daily” | “weekly” | “monthly” (required)
options.WEB_PUSH.off object
options.WEB_PUSH.off.enabled boolean (required)
options.WEB_PUSH.instant object
options.WEB_PUSH.instant.enabled boolean (required)
options.WEB_PUSH.hourly object
options.WEB_PUSH.hourly.enabled boolean (required)
options.WEB_PUSH.daily object
options.WEB_PUSH.daily.enabled boolean (required)
options.WEB_PUSH.daily.hour string
options.WEB_PUSH.weekly object
options.WEB_PUSH.weekly.enabled boolean (required)
options.WEB_PUSH.weekly.hour string
options.WEB_PUSH.weekly.day string
options.WEB_PUSH.monthly object
options.WEB_PUSH.monthly.enabled boolean (required)
options.WEB_PUSH.monthly.hour string
options.WEB_PUSH.monthly.date “first” | “last”
options.SLACK object
options.SLACK.defaultDeliveryOption “off” | “instant” | “hourly” | “daily” | “weekly” | “monthly” (required)
options.SLACK.off object
options.SLACK.off.enabled boolean (required)
options.SLACK.instant object
options.SLACK.instant.enabled boolean (required)
options.SLACK.hourly object
options.SLACK.hourly.enabled boolean (required)
options.SLACK.daily object
options.SLACK.daily.enabled boolean (required)
options.SLACK.daily.hour string
options.SLACK.weekly object
options.SLACK.weekly.enabled boolean (required)
options.SLACK.weekly.hour string
options.SLACK.weekly.day string
options.SLACK.monthly object
options.SLACK.monthly.enabled boolean (required)
options.SLACK.monthly.hour string
options.SLACK.monthly.date “first” | “last”

Usage

account_get_usage()

Get usage for the authenticated account

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
response = await client.account.account_get_usage()
print(response)

Parameters

This endpoint does not need any parameter.

account_get_usage_history()

Get usage history

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
start_date = 'start_date_example'
end_date = 'end_date_example'
group_by = 'group_by_example'
response = await client.account.account_get_usage_history(start_date, end_date, group_by=group_by)
print(response)

Parameters

Name Type Description Notes
start_date str Start date (YYYY-MM-DD) for the range
end_date str End date (YYYY-MM-DD) for the range
group_by str calendar (UTC months, default) or billing (account billing cycles) [optional]

User

user_get_account_metadata()

Get account metadata

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
response = await client.user.user_get_account_metadata()
print(response)

Parameters

This endpoint does not need any parameter.

user_get_user()

Get a user by ID

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
user_id = 'user_id_example'
response = await client.user.user_get_user(user_id)
print(response)

Parameters

Name Type Description Notes
user_id str User ID

user_identify()

Create or update a user with the given ID

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
user_id = 'user_id_example'
post_user_request = PostUserRequest()
response = await client.user.user_identify(user_id, post_user_request)
print(response)

Parameters

Name Type Description Notes
user_id str User ID
post_user_request PostUserRequest See Request Body Properties below

Request Body Properties

Name Type Description
id string Unique user identifier. Required.
email string User’s email address for email notifications.
number string User’s phone number for SMS/call notifications.
pushTokens object[] Mobile push tokens (FCM, APN) for push notifications.
pushTokens[].type “FCM” | “APN” (required)
pushTokens[].token string (required)
pushTokens[].device object (required)
pushTokens[].device.app_id string
pushTokens[].device.ad_id string
pushTokens[].device.device_id string (required)
pushTokens[].device.platform string
pushTokens[].device.manufacturer string
pushTokens[].device.model string
pushTokens[].environment string used by APN to differentiate between sandbox and production builds (sandbox/undefined or production)
webPushTokens object[] Web push subscription config from the browser.
webPushTokens[].sub object (required) Configuration for a Push Subscription. This can be obtained on the frontend by calling serviceWorkerRegistration.pushManager.subscribe(). The expected format is the same output as JSON.stringify’ing a PushSubscription in the browser.
webPushTokens[].sub.endpoint string (required)
webPushTokens[].sub.keys object (required)
webPushTokens[].sub.keys.p256dh string (required)
webPushTokens[].sub.keys.auth string (required)
timezone string User’s timezone (e.g. “America/New_York”) for scheduling.
slackChannel string The destination channel of slack notifications sent to this user. Can be either of the following: - Channel name, e.g. “test” - Channel name with # prefix, e.g. “#test” - Channel ID, e.g. “C1234567890” - User ID for DM, e.g. “U1234567890” - Username with @ prefix, e.g. “@test”
slackToken object
slackToken.access_token string
slackToken.app_id string
slackToken.authed_user object
slackToken.authed_user.access_token string
slackToken.authed_user.expires_in number
slackToken.authed_user.id string
slackToken.authed_user.refresh_token string
slackToken.authed_user.scope string
slackToken.authed_user.token_type string
slackToken.bot_user_id string
slackToken.enterprise object
slackToken.enterprise.id string
slackToken.enterprise.name string
slackToken.error string
slackToken.expires_in number
slackToken.incoming_webhook object
slackToken.incoming_webhook.channel string
slackToken.incoming_webhook.channel_id string
slackToken.incoming_webhook.configuration_url string
slackToken.incoming_webhook.url string
slackToken.is_enterprise_install boolean
slackToken.needed string
slackToken.ok boolean (required)
slackToken.provided string
slackToken.refresh_token string
slackToken.scope string
slackToken.team object
slackToken.team.id string
slackToken.team.name string
slackToken.token_type string
slackToken.warning string
slackToken.response_metadata object
slackToken.response_metadata.warnings string[]
slackToken.response_metadata.next_cursor string
slackToken.response_metadata.scopes string[]
slackToken.response_metadata.acceptedScopes string[]
slackToken.response_metadata.retryAfter number
slackToken.response_metadata.messages string[]
properties Record<string, string | number | boolean> Custom key-value properties synced by the developer, used for audience segmentation (e.g. broadcast filters on user.properties.plan). Incremental identify calls shallow-merge keys (unset keys are preserved). Limits: max 25 keys, key length <= 64, string values <= 256 chars, serialized size <= 1KB.

Users

users_delete_user()

Delete a user

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
user_id = 'user_id_example'
env_id = 'env_id_example'
response = await client.users.users_delete_user(user_id, env_id=env_id)
print(response)

Parameters

Name Type Description Notes
user_id str User ID
env_id str Environment ID (required when using JWT auth) [optional]

users_list_users()

Get all users for an environment with pagination support

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
limit = 3.4
next_token = 'next_token_example'
env_id = 'env_id_example'
response = await client.users.users_list_users(limit, next_token, env_id=env_id)
print(response)

Parameters

Name Type Description Notes
limit float Maximum number of users to return (default
next_token str Pagination token for next page
env_id str Environment ID (required when using JWT auth) [optional]

users_remove_user_from_suppression()

Remove user suppression status for a specific channel

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
user_id = 'user_id_example'
channel = 'channel_example'
env_id = 'env_id_example'
response = await client.users.users_remove_user_from_suppression(user_id, channel, env_id=env_id)
print(response)

Parameters

Name Type Description Notes
user_id str User ID
channel str Channel type (EMAIL)
env_id str Environment ID (required when using JWT auth) [optional]

Voice

voice_arm_inbound_claim()

Arm the shared test number

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
arm_voice_inbound_claim_request = ArmVoiceInboundClaimRequest()
response = await client.voice.voice_arm_inbound_claim(arm_voice_inbound_claim_request)
print(response)

Parameters

Name Type Description Notes
arm_voice_inbound_claim_request ArmVoiceInboundClaimRequest See Request Body Properties below

Request Body Properties

Name Type Description
inbound object | object | object | object | object | object (required)
inbound.type “script” (required)
inbound.steps object[] (required)
inbound.steps[].verb “Say” (required)
inbound.steps[].text string (required)
inbound.stream object What the call socket carries. Omitted means the socket is open and carries neither.
inbound.stream.audio boolean Live call audio. Omitted means off.
inbound.stream.transcript “single” | “multichannel” single mixes every channel into one stream. multichannel transcribes each channel. Omitted means off.
inbound.privacy object Omitted record and transcript mean both are off.
inbound.privacy.record boolean
inbound.privacy.transcript “single” | “multichannel” single mixes every channel into one stream. multichannel transcribes each channel. Omitted means off.

voice_call()

Place an outbound call. The config is not saved

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
voice_call_request = VoiceCallRequest()
response = await client.voice.voice_call(voice_call_request)
print(response)

Parameters

Name Type Description Notes
voice_call_request VoiceCallRequest See Request Body Properties below

Request Body Properties

Name Type Description
to string (required) E.164 number to dial.
config object | object | object | object (required)
config.type “script” (required)
config.steps object[] (required)
config.steps[].verb “Say” (required)
config.steps[].text string (required)
config.voicemailAction “hangup” | “message” | “continue” What to do when an answering machine picks up. hangup ends the call, message plays voicemailMessage, continue keeps talking. Default: continue.
config.voicemailMessage string
config.stream object What the call socket carries. Omitted means the socket is open and carries neither.
config.stream.audio boolean Live call audio. Omitted means off.
config.stream.transcript “single” | “multichannel” single mixes every channel into one stream. multichannel transcribes each channel. Omitted means off.
config.privacy object Omitted record and transcript mean both are off.
config.privacy.record boolean
config.privacy.transcript “single” | “multichannel” single mixes every channel into one stream. multichannel transcribes each channel. Omitted means off.
variables Record<string, string> Optional per-call {{variable}} overrides.

voice_clear_number_inbound()

Remove inbound call behavior from a number this account owns

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
phone_number = 'phone_number_example'
response = await client.voice.voice_clear_number_inbound(phone_number)
print(response)

Parameters

Name Type Description Notes
phone_number str E.164 phone number

voice_create_browser_call()

Place a browser playground call

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
voice_browser_call_request = VoiceBrowserCallRequest()
response = await client.voice.voice_create_browser_call(voice_browser_call_request)
print(response)

Parameters

Name Type Description Notes
voice_browser_call_request VoiceBrowserCallRequest See Request Body Properties below

Request Body Properties

Name Type Description
config object | object | object | object | object | object | object | object | object | object (required) Agent behavior for this browser call. Script calls use POST /voice/call.
variables Record<string, string> Optional per-call {{variable}} overrides for browser playground.
direction “inbound” | “outbound” inbound speaks the greeting. outbound speaks the opener. Omitted means outbound.

voice_get_call()

Get a call recording and transcript

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
tracking_id = 'tracking_id_example'
response = await client.voice.voice_get_call(tracking_id)
print(response)

Parameters

Name Type Description Notes
tracking_id str Call tracking id

voice_list_calls()

List recent calls newest-first (30-day retention)

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
limit = 3.4
cursor = 'cursor_example'
response = await client.voice.voice_list_calls(limit=limit, cursor=cursor)
print(response)

Parameters

Name Type Description Notes
limit float Page size (default 25, max 100) [optional]
cursor str Pagination cursor from a previous response [optional]

voice_put_number_inbound()

Store inbound call behavior on a number this account owns

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
phone_number = 'phone_number_example'
inbound_config = InboundConfig()
response = await client.voice.voice_put_number_inbound(phone_number, inbound_config)
print(response)

Parameters

Name Type Description Notes
phone_number str E.164 phone number
inbound_config InboundConfig See Request Body Properties below

voice_transfer()

Move a live phone call to another number

from pingram import Pingram
async with Pingram(api_key="pingram_sk_...") as client:
tracking_id = 'tracking_id_example'
transfer_call_request = TransferCallRequest()
response = await client.voice.voice_transfer(tracking_id, transfer_call_request)
print(response)

Parameters

Name Type Description Notes
tracking_id str Call tracking id
transfer_call_request TransferCallRequest See Request Body Properties below

Request Body Properties

Name Type Description
to string (required) E.164 number to move the caller to.
holdSay string Spoken once to the caller while they wait. If holdAudio is also set, this sentence plays first and then the audio.
holdAudio string builtin:soft-piano, builtin:calm, builtin:bright, or an HTTPS MP3 or WAV. Loops until the call connects. Omit it and the caller hears ringing.
receiverSay string Spoken to the person who answers, before the caller is connected.