Odoo 19.0 Community · Persistent

sms.sms: fields, relations and API

The sms.sms model ("Outgoing SMS") is a persistent model declared by the SMS gateway module, then extended by 2 other modules. It exposes 19 fields, 13 of them declared directly on the model; 2 fields from other models point to it. Below you will find every field with its technical name, type, label and relations, followed by an Odoo 19 JSON-2 API call.

View source code Search another model

Model identity

Technical name: sms.sms
Label: Outgoing SMS
Type: Persistent (models.Model)
SQL table: sms_sms
Origin module: SMS gateway (sms)
Extended by: mass_mailing_sms, sms_twilio
Default order (_order): id DESC
Display field (_rec_name): number

Model fields

13 own fields, 0 inherited from mixins and 6 automatic ORM fields. Click a name to get a direct link to that field.

Hide inherited fields

19 of 19 fields shown

Technical name	Label	Type	Details
body	Body	`text`
failure_type	Failure Type	`selection`	Values: `unknown` (Unknown error), `sms_number_missing` (Missing Number), `sms_number_format` (Wrong Number Format), `sms_country_not_supported` (Country Not Supported), `sms_registration_needed` (Country-specific Registration Required), `sms_credit` (Insufficient Credit), `sms_server` (Server Error), `sms_acc` (Unregistered Account), `sms_blacklist` (Blacklisted), `sms_duplicate` (Duplicate), `sms_optout` (Opted Out)
mail_message_id	Mail Message	`many2one` → mail.message
mailing_id	Mass Mailing	`many2one` → mailing.mailing	added by SMS Marketing (`mass_mailing_sms`)
mailing_trace_ids	Statistics	`one2many` → mailing.trace	inverse: `sms_id_int` added by SMS Marketing (`mass_mailing_sms`)
number	Number	`char`
partner_id	Customer	`many2one` → res.partner
record_company_id	Company	`many2one` → res.company	added by Twilio SMS (`sms_twilio`)
sms_tracker_id	SMS trackers	`many2one` → sms.tracker	computed
sms_twilio_sid	Sms Twilio Sid	`char`	related: `sms_tracker_id.sms_twilio_sid` added by Twilio SMS (`sms_twilio`)
state	SMS Status	`selection`	requiredread-only Values: `outgoing` (In Queue), `process` (Processing), `pending` (Sent), `sent` (Delivered), `error` (Error), `canceled` (Cancelled)
to_delete	Marked for deletion Will automatically be deleted, while notifications will not be deleted in any case.	`boolean`
uuid	UUID Alternate way to identify a SMS record, used for delivery reports	`char`	read-only
create_date	Created on	`datetime`	read-onlyautomatic
create_uid	Created by	`many2one` → res.users	read-onlyautomatic
display_name	Display Name	`char`	read-onlycomputedautomatic
id	ID	`integer`	read-onlyautomatic
write_date	Last Updated on	`datetime`	read-onlyautomatic
write_uid	Last Updated by	`many2one` → res.users	read-onlyautomatic

Relations

Models linked from this model

mail.message: mail_message_id
mailing.mailing: mailing_id
mailing.trace: mailing_trace_ids
res.company: record_company_id
res.partner: partner_id
sms.tracker: sms_tracker_id

Fields of other models pointing here

mail.notification: sms_id
mailing.trace: sms_id

Reading this model through the API

Odoo 19 JSON-2 API call reading the first five records with real fields of the model. Replace the instance, database and API key with your own.

curl

curl -X POST "https://your-instance.odoo.com/json/2/sms.sms/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: your-db" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["number","state","mail_message_id","mailing_id","partner_id"],"limit":5}'

Python (requests)

import requests

BASE_URL = "https://your-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "your-db"}

res = requests.post(
    f"{BASE_URL}/sms.sms/search_read",
    headers=headers,
    json={"domain": [], "fields": ["number","state","mail_message_id","mailing_id","partner_id"], "limit": 5},
)
res.raise_for_status()
print(res.json())

External API access requires Odoo's Custom plan.
XML-RPC and JSON-RPC will be removed in Odoo 22 (fall 2028): use JSON-2.
The access rights and record rules of the key's user apply.

Cite this tool

Writing a tutorial, internal documentation or a forum answer? Copy this link to send your readers to the up-to-date reference.

<a href="https://aidoo.ai/en/outils/explorateur-modeles-odoo/sms-sms">sms.sms (Odoo 19.0)</a>

Sources

Data verified on September 23, 2026 · Odoo 19.0 Community

Have an Odoo project, or want to put your ERP to work with AI? Let's talk

Implementation, custom module development, connecting Claude or ChatGPT to your data: tell us about your context and we will reply within 24 business hours.