{"id":"ad01987a-a489-4e55-b957-b4d4bdf5f06e","shortId":"aSrFCG","kind":"skill","title":"telnyx-account-notifications-python","tagline":">-","description":"<!-- Auto-generated from Telnyx OpenAPI specs. Do not edit. -->\n\n# Telnyx Account Notifications - Python\n\n## Installation\n\n```bash\npip install telnyx\n```\n\n## Setup\n\n```python\nimport os\nfrom telnyx import Telnyx\n\nclient = Telnyx(\n    api_key=os.environ.get(\"TELNYX_API_KEY\"),  # This is the default and can be omitted\n)\n```\n\nAll examples below assume `client` is already initialized as shown above.\n\n## Error Handling\n\nAll API calls can fail with network errors, rate limits (429), validation errors (422),\nor authentication errors (401). Always handle errors in production code:\n\n```python\nimport telnyx\n\ntry:\n    result = client.messages.send(to=\"+13125550001\", from_=\"+13125550002\", text=\"Hello\")\nexcept telnyx.APIConnectionError:\n    print(\"Network error — check connectivity and retry\")\nexcept telnyx.RateLimitError:\n    # 429: rate limited — wait and retry with exponential backoff\n    import time\n    time.sleep(1)  # Check Retry-After header for actual delay\nexcept telnyx.APIStatusError as e:\n    print(f\"API error {e.status_code}: {e.message}\")\n    if e.status_code == 422:\n        print(\"Validation error — check required fields and formats\")\n```\n\nCommon error codes: `401` invalid API key, `403` insufficient permissions,\n`404` resource not found, `422` validation error (check field formats),\n`429` rate limited (retry with exponential backoff).\n\n## Important Notes\n\n- **Pagination:** List methods return an auto-paginating iterator. Use `for item in page_result:` to iterate through all pages automatically.\n\n## List notification channels\n\nList notification channels.\n\n`GET /notification_channels`\n\n```python\npage = client.notification_channels.list()\npage = page.data[0]\nprint(page.id)\n```\n\nReturns: `channel_destination` (string), `channel_type_id` (enum: sms, voice, email, webhook), `created_at` (date-time), `id` (string), `notification_profile_id` (string), `updated_at` (date-time)\n\n## Create a notification channel\n\nCreate a notification channel.\n\n`POST /notification_channels`\n\nOptional: `channel_destination` (string), `channel_type_id` (enum: sms, voice, email, webhook), `created_at` (date-time), `id` (string), `notification_profile_id` (string), `updated_at` (date-time)\n\n```python\nnotification_channel = client.notification_channels.create(\n    channel_type_id=\"webhook\",\n    channel_destination=\"https://example.com/webhooks\",\n)\nprint(notification_channel.data)\n```\n\nReturns: `channel_destination` (string), `channel_type_id` (enum: sms, voice, email, webhook), `created_at` (date-time), `id` (string), `notification_profile_id` (string), `updated_at` (date-time)\n\n## Get a notification channel\n\nGet a notification channel.\n\n`GET /notification_channels/{id}`\n\n```python\nnotification_channel = client.notification_channels.retrieve(\n    \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\",\n)\nprint(notification_channel.data)\n```\n\nReturns: `channel_destination` (string), `channel_type_id` (enum: sms, voice, email, webhook), `created_at` (date-time), `id` (string), `notification_profile_id` (string), `updated_at` (date-time)\n\n## Update a notification channel\n\nUpdate a notification channel.\n\n`PATCH /notification_channels/{id}`\n\nOptional: `channel_destination` (string), `channel_type_id` (enum: sms, voice, email, webhook), `created_at` (date-time), `id` (string), `notification_profile_id` (string), `updated_at` (date-time)\n\n```python\nnotification_channel = client.notification_channels.update(\n    notification_channel_id=\"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\",\n)\nprint(notification_channel.data)\n```\n\nReturns: `channel_destination` (string), `channel_type_id` (enum: sms, voice, email, webhook), `created_at` (date-time), `id` (string), `notification_profile_id` (string), `updated_at` (date-time)\n\n## Delete a notification channel\n\nDelete a notification channel.\n\n`DELETE /notification_channels/{id}`\n\n```python\nnotification_channel = client.notification_channels.delete(\n    \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\",\n)\nprint(notification_channel.data)\n```\n\nReturns: `channel_destination` (string), `channel_type_id` (enum: sms, voice, email, webhook), `created_at` (date-time), `id` (string), `notification_profile_id` (string), `updated_at` (date-time)\n\n## List all Notifications Events Conditions\n\nReturns a list of your notifications events conditions.\n\n`GET /notification_event_conditions`\n\n```python\npage = client.notification_event_conditions.list()\npage = page.data[0]\nprint(page.id)\n```\n\nReturns: `allow_multiple_channels` (boolean), `associated_record_type` (enum: account, phone_number), `asynchronous` (boolean), `created_at` (date-time), `description` (string), `enabled` (boolean), `id` (string), `name` (string), `notification_event_id` (string), `parameters` (array[object]), `supported_channels` (array[string]), `updated_at` (date-time)\n\n## List all Notifications Events\n\nReturns a list of your notifications events.\n\n`GET /notification_events`\n\n```python\npage = client.notification_events.list()\npage = page.data[0]\nprint(page.id)\n```\n\nReturns: `created_at` (date-time), `enabled` (boolean), `id` (string), `name` (string), `notification_category` (string), `updated_at` (date-time)\n\n## List all Notifications Profiles\n\nReturns a list of your notifications profiles.\n\n`GET /notification_profiles`\n\n```python\npage = client.notification_profiles.list()\npage = page.data[0]\nprint(page.id)\n```\n\nReturns: `created_at` (date-time), `id` (string), `name` (string), `updated_at` (date-time)\n\n## Create a notification profile\n\nCreate a notification profile.\n\n`POST /notification_profiles`\n\nOptional: `created_at` (date-time), `id` (string), `name` (string), `updated_at` (date-time)\n\n```python\nnotification_profile = client.notification_profiles.create(\n    name=\"My Notification Profile\",\n)\nprint(notification_profile.data)\n```\n\nReturns: `created_at` (date-time), `id` (string), `name` (string), `updated_at` (date-time)\n\n## Get a notification profile\n\nGet a notification profile.\n\n`GET /notification_profiles/{id}`\n\n```python\nnotification_profile = client.notification_profiles.retrieve(\n    \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\",\n)\nprint(notification_profile.data)\n```\n\nReturns: `created_at` (date-time), `id` (string), `name` (string), `updated_at` (date-time)\n\n## Update a notification profile\n\nUpdate a notification profile.\n\n`PATCH /notification_profiles/{id}`\n\nOptional: `created_at` (date-time), `id` (string), `name` (string), `updated_at` (date-time)\n\n```python\nnotification_profile = client.notification_profiles.update(\n    notification_profile_id=\"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\",\n)\nprint(notification_profile.data)\n```\n\nReturns: `created_at` (date-time), `id` (string), `name` (string), `updated_at` (date-time)\n\n## Delete a notification profile\n\nDelete a notification profile.\n\n`DELETE /notification_profiles/{id}`\n\n```python\nnotification_profile = client.notification_profiles.delete(\n    \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\",\n)\nprint(notification_profile.data)\n```\n\nReturns: `created_at` (date-time), `id` (string), `name` (string), `updated_at` (date-time)\n\n## List notification settings\n\nList notification settings.\n\n`GET /notification_settings`\n\n```python\npage = client.notification_settings.list()\npage = page.data[0]\nprint(page.id)\n```\n\nReturns: `associated_record_type` (string), `associated_record_type_value` (string), `created_at` (date-time), `id` (string), `notification_channel_id` (string), `notification_event_condition_id` (string), `notification_profile_id` (string), `parameters` (array[object]), `status` (enum: enabled, enable-received, enable-pending, enable-submitted, delete-received, delete-pending, delete-submitted, deleted), `updated_at` (date-time)\n\n## Add a Notification Setting\n\nAdd a notification setting.\n\n`POST /notification_settings`\n\nOptional: `associated_record_type` (string), `associated_record_type_value` (string), `created_at` (date-time), `id` (string), `notification_channel_id` (string), `notification_event_condition_id` (string), `notification_profile_id` (string), `parameters` (array[object]), `status` (enum: enabled, enable-received, enable-pending, enable-submitted, delete-received, delete-pending, delete-submitted, deleted), `updated_at` (date-time)\n\n```python\nnotification_setting = client.notification_settings.create()\nprint(notification_setting.data)\n```\n\nReturns: `associated_record_type` (string), `associated_record_type_value` (string), `created_at` (date-time), `id` (string), `notification_channel_id` (string), `notification_event_condition_id` (string), `notification_profile_id` (string), `parameters` (array[object]), `status` (enum: enabled, enable-received, enable-pending, enable-submitted, delete-received, delete-pending, delete-submitted, deleted), `updated_at` (date-time)\n\n## Get a notification setting\n\nGet a notification setting.\n\n`GET /notification_settings/{id}`\n\n```python\nnotification_setting = client.notification_settings.retrieve(\n    \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\",\n)\nprint(notification_setting.data)\n```\n\nReturns: `associated_record_type` (string), `associated_record_type_value` (string), `created_at` (date-time), `id` (string), `notification_channel_id` (string), `notification_event_condition_id` (string), `notification_profile_id` (string), `parameters` (array[object]), `status` (enum: enabled, enable-received, enable-pending, enable-submitted, delete-received, delete-pending, delete-submitted, deleted), `updated_at` (date-time)\n\n## Delete a notification setting\n\nDelete a notification setting.\n\n`DELETE /notification_settings/{id}`\n\n```python\nnotification_setting = client.notification_settings.delete(\n    \"182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e\",\n)\nprint(notification_setting.data)\n```\n\nReturns: `associated_record_type` (string), `associated_record_type_value` (string), `created_at` (date-time), `id` (string), `notification_channel_id` (string), `notification_event_condition_id` (string), `notification_profile_id` (string), `parameters` (array[object]), `status` (enum: enabled, enable-received, enable-pending, enable-submitted, delete-received, delete-pending, delete-submitted, deleted), `updated_at` (date-time)","tags":["telnyx","account","notifications","python","team-telnyx","agent-skills","ai-coding-agent","claude-code","cpaas","cursor","iot","llm"],"capabilities":["skill","source-team-telnyx","skill-telnyx-account-notifications-python","topic-agent-skills","topic-ai-coding-agent","topic-claude-code","topic-cpaas","topic-cursor","topic-iot","topic-llm","topic-sdk","topic-sip","topic-sms","topic-speech-to-text","topic-telephony"],"categories":["ai"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/team-telnyx/ai/telnyx-account-notifications-python","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add team-telnyx/ai","source_repo":"https://github.com/team-telnyx/ai","install_from":"skills.sh"}},"qualityScore":"0.533","qualityRationale":"deterministic score 0.53 from registry signals: · indexed on github topic:agent-skills · 167 github stars · SKILL.md body (10,083 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T12:54:42.246Z","embedding":null,"createdAt":"2026-04-18T22:06:04.418Z","updatedAt":"2026-04-22T12:54:42.246Z","lastSeenAt":"2026-04-22T12:54:42.246Z","tsv":"'+13125550001':83 '+13125550002':85 '/notification_channels':200,246,327,378,460 '/notification_event_conditions':516 '/notification_events':580 '/notification_profiles':621,654,704,742,798 '/notification_settings':834,912,1048,1131 '/webhooks':287 '0':206,522,586,627,840 '1':111 '182bd5e5':334,416,467,711,767,805,1055,1138 '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e':333,415,466,710,766,804,1054,1137 '401':69,146 '403':150 '404':153 '422':65,134,157 '429':62,99,163 '4fe4':336,418,469,713,769,807,1057,1140 '6e1a':335,417,468,712,768,806,1056,1139 'a799':337,419,470,714,770,808,1058,1141 'aa6d9a6ab26e':338,420,471,715,771,809,1059,1142 'account':3,7,534 'actual':118 'add':903,907 'allow':526 'alreadi':45 'alway':70 'api':25,29,53,126,148 'array':557,561,874,944,1010,1093,1176 'associ':530,844,848,914,918,980,984,1063,1067,1146,1150 'assum':42 'asynchron':537 'authent':67 'auto':178 'auto-pagin':177 'automat':192 'backoff':107,169 'bash':11 'boolean':529,538,547,596 'call':54 'categori':602 'channel':195,198,210,213,240,244,248,251,277,279,283,291,294,321,325,331,342,345,372,376,381,384,410,413,424,427,454,458,464,475,478,528,560,861,931,997,1080,1163 'check':93,112,138,160 'client':23,43 'client.messages.send':81 'client.notification_channels.create':278 'client.notification_channels.delete':465 'client.notification_channels.list':203 'client.notification_channels.retrieve':332 'client.notification_channels.update':411 'client.notification_event_conditions.list':519 'client.notification_events.list':583 'client.notification_profiles.create':673 'client.notification_profiles.delete':803 'client.notification_profiles.list':624 'client.notification_profiles.retrieve':709 'client.notification_profiles.update':762 'client.notification_settings.create':976 'client.notification_settings.delete':1136 'client.notification_settings.list':837 'client.notification_settings.retrieve':1053 'code':75,129,133,145 'common':143 'condit':506,514,866,936,1002,1085,1168 'connect':94 'creat':221,237,241,259,302,353,392,435,486,539,590,631,645,649,656,681,719,745,775,813,853,923,989,1072,1155 'date':224,235,262,273,305,316,356,367,395,406,438,449,489,500,542,566,593,607,634,643,659,668,684,693,722,731,748,757,778,787,816,825,856,901,926,971,992,1037,1075,1120,1158,1203 'date-tim':223,234,261,272,304,315,355,366,394,405,437,448,488,499,541,565,592,606,633,642,658,667,683,692,721,730,747,756,777,786,815,824,855,900,925,970,991,1036,1074,1119,1157,1202 'default':34 'delay':119 'delet':451,455,459,789,793,797,889,892,895,897,959,962,965,967,1025,1028,1031,1033,1108,1111,1114,1116,1122,1126,1130,1191,1194,1197,1199 'delete-pend':891,961,1027,1110,1193 'delete-receiv':888,958,1024,1107,1190 'delete-submit':894,964,1030,1113,1196 'descript':544 'destin':211,249,284,292,343,382,425,476 'e':123 'e.message':130 'e.status':128,132 'email':219,257,300,351,390,433,484 'enabl':546,595,878,880,883,886,948,950,953,956,1014,1016,1019,1022,1097,1099,1102,1105,1180,1182,1185,1188 'enable-pend':882,952,1018,1101,1184 'enable-receiv':879,949,1015,1098,1181 'enable-submit':885,955,1021,1104,1187 'enum':216,254,297,348,387,430,481,533,877,947,1013,1096,1179 'error':50,59,64,68,72,92,127,137,144,159 'event':505,513,553,571,578,865,935,1001,1084,1167 'exampl':40 'example.com':286 'example.com/webhooks':285 'except':88,97,120 'exponenti':106,168 'f':125 'fail':56 'field':140,161 'format':142,162 'found':156 'get':199,318,322,326,515,579,620,695,699,703,833,1039,1043,1047 'handl':51,71 'header':116 'hello':87 'id':215,226,230,253,264,268,281,296,307,311,328,347,358,362,379,386,397,401,414,429,440,444,461,480,491,495,548,554,597,636,661,686,705,724,743,750,765,780,799,818,858,862,867,871,928,932,937,941,994,998,1003,1007,1049,1077,1081,1086,1090,1132,1160,1164,1169,1173 'import':17,21,77,108,170 'initi':46 'instal':10,13 'insuffici':151 'invalid':147 'item':183 'iter':180,188 'key':26,30,149 'limit':61,101,165 'list':173,193,196,502,509,568,574,609,615,827,830 'method':174 'multipl':527 'name':550,599,638,663,674,688,726,752,782,820 'network':58,91 'note':171 'notif':4,8,194,197,228,239,243,266,276,309,320,324,330,360,371,375,399,409,412,442,453,457,463,493,504,512,552,570,577,601,611,618,647,651,671,676,697,701,707,735,739,760,763,791,795,801,828,831,860,864,869,905,909,930,934,939,974,996,1000,1005,1041,1045,1051,1079,1083,1088,1124,1128,1134,1162,1166,1171 'notification_channel.data':289,340,422,473 'notification_profile.data':679,717,773,811 'notification_setting.data':978,1061,1144 'number':536 'object':558,875,945,1011,1094,1177 'omit':38 'option':247,380,655,744,913 'os':18 'os.environ.get':27 'page':185,191,202,204,518,520,582,584,623,625,836,838 'page.data':205,521,585,626,839 'page.id':208,524,588,629,842 'pagin':172,179 'paramet':556,873,943,1009,1092,1175 'patch':377,741 'pend':884,893,954,963,1020,1029,1103,1112,1186,1195 'permiss':152 'phone':535 'pip':12 'post':245,653,911 'print':90,124,135,207,288,339,421,472,523,587,628,678,716,772,810,841,977,1060,1143 'product':74 'profil':229,267,310,361,400,443,494,612,619,648,652,672,677,698,702,708,736,740,761,764,792,796,802,870,940,1006,1089,1172 'python':5,9,16,76,201,275,329,408,462,517,581,622,670,706,759,800,835,973,1050,1133 'rate':60,100,164 'receiv':881,890,951,960,1017,1026,1100,1109,1183,1192 'record':531,845,849,915,919,981,985,1064,1068,1147,1151 'requir':139 'resourc':154 'result':80,186 'retri':96,104,114,166 'retry-aft':113 'return':175,209,290,341,423,474,507,525,572,589,613,630,680,718,774,812,843,979,1062,1145 'set':829,832,906,910,975,1042,1046,1052,1125,1129,1135 'setup':15 'shown':48 'skill' 'skill-telnyx-account-notifications-python' 'sms':217,255,298,349,388,431,482 'source-team-telnyx' 'status':876,946,1012,1095,1178 'string':212,227,231,250,265,269,293,308,312,344,359,363,383,398,402,426,441,445,477,492,496,545,549,551,555,562,598,600,603,637,639,662,664,687,689,725,727,751,753,781,783,819,821,847,852,859,863,868,872,917,922,929,933,938,942,983,988,995,999,1004,1008,1066,1071,1078,1082,1087,1091,1149,1154,1161,1165,1170,1174 'submit':887,896,957,966,1023,1032,1106,1115,1189,1198 'support':559 'telnyx':2,6,14,20,22,24,28,78 'telnyx-account-notifications-python':1 'telnyx.apiconnectionerror':89 'telnyx.apistatuserror':121 'telnyx.ratelimiterror':98 'text':86 'time':109,225,236,263,274,306,317,357,368,396,407,439,450,490,501,543,567,594,608,635,644,660,669,685,694,723,732,749,758,779,788,817,826,857,902,927,972,993,1038,1076,1121,1159,1204 'time.sleep':110 'topic-agent-skills' 'topic-ai-coding-agent' 'topic-claude-code' 'topic-cpaas' 'topic-cursor' 'topic-iot' 'topic-llm' 'topic-sdk' 'topic-sip' 'topic-sms' 'topic-speech-to-text' 'topic-telephony' 'tri':79 'type':214,252,280,295,346,385,428,479,532,846,850,916,920,982,986,1065,1069,1148,1152 'updat':232,270,313,364,369,373,403,446,497,563,604,640,665,690,728,733,737,754,784,822,898,968,1034,1117,1200 'use':181 'valid':63,136,158 'valu':851,921,987,1070,1153 'voic':218,256,299,350,389,432,483 'wait':102 'webhook':220,258,282,301,352,391,434,485","prices":[{"id":"64172209-d787-4ca3-b935-d969de69d29b","listingId":"ad01987a-a489-4e55-b957-b4d4bdf5f06e","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"team-telnyx","category":"ai","install_from":"skills.sh"},"createdAt":"2026-04-18T22:06:04.418Z"}],"sources":[{"listingId":"ad01987a-a489-4e55-b957-b4d4bdf5f06e","source":"github","sourceId":"team-telnyx/ai/telnyx-account-notifications-python","sourceUrl":"https://github.com/team-telnyx/ai/tree/main/skills/telnyx-account-notifications-python","isPrimary":false,"firstSeenAt":"2026-04-18T22:06:04.418Z","lastSeenAt":"2026-04-22T12:54:42.246Z"}],"details":{"listingId":"ad01987a-a489-4e55-b957-b4d4bdf5f06e","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"team-telnyx","slug":"telnyx-account-notifications-python","github":{"repo":"team-telnyx/ai","stars":167,"topics":["agent-skills","ai","ai-coding-agent","claude-code","cpaas","cursor","iot","llm","sdk","sip","sms","speech-to-text","telephony","telnyx","tts","twilio-migration","voice-agents","voice-ai","webrtc","windsurf"],"license":"mit","html_url":"https://github.com/team-telnyx/ai","pushed_at":"2026-04-21T22:09:49Z","description":"Official one-stop shop for AI Agents and developers building with Telnyx.","skill_md_sha":"f4460ec5b1648375e431f673df49826cd8643e7b","skill_md_path":"skills/telnyx-account-notifications-python/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/team-telnyx/ai/tree/main/skills/telnyx-account-notifications-python"},"layout":"multi","source":"github","category":"ai","frontmatter":{"name":"telnyx-account-notifications-python","description":">-"},"skills_sh_url":"https://skills.sh/team-telnyx/ai/telnyx-account-notifications-python"},"updatedAt":"2026-04-22T12:54:42.246Z"}}