---
updatedAt: 2026-04-23T12:53:11.000Z
agentTools:
  projectIndex: https://developers.themarketer.com/llms.txt
---

# Send SMS

If you want to send your transactional SMS through theMarketer (for example order confirmations, delivery information etc.), you can do so by using our Transactional SMS API. Keep in mind that this service is billed separately from your theMarketer subscription.

By default, the Transactional SMS functionality is in Sanbox mode, which means that SMS can only be sent out to phone numbers which are defined in the sandbox recipients list.

**When you plan to go live, please ensure that you have added transactional SMS credit to your account, and that you have used the Go Live button in the interface.**

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "theMarketer API",
    "version": "1.0.0",
    "description": ""
  },
  "servers": [
    {
      "url": "https://t.themarketer.com"
    }
  ],
  "paths": {
    "/api/v1/transactional/send-sms": {
      "parameters": [],
      "post": {
        "summary": "Send SMS",
        "tags": [],
        "parameters": [
          {
            "name": "k",
            "in": "query",
            "required": true,
            "deprecated": false,
            "schema": {
              "type": "string"
            },
            "example": "REST_KEY"
          },
          {
            "name": "u",
            "in": "query",
            "required": true,
            "deprecated": false,
            "schema": {
              "type": "string"
            },
            "example": "CUSTOMER_ID"
          }
        ],
        "responses": {
          "200": {
            "description": "200 Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "result": {
                      "type": "string",
                      "example": "success",
                      "description": "success"
                    },
                    "message": {
                      "type": "string",
                      "example": "Sent",
                      "description": "Sent"
                    },
                    "message_id": {
                      "type": "string",
                      "example": "688237bd72d16367d6062fca",
                      "description": "688237bd72d16367d6062fca"
                    }
                  }
                },
                "example": {
                  "result": "success",
                  "message": "Sent",
                  "message_id": "688237bd72d16367d6062fca"
                }
              }
            }
          },
          "404": {
            "description": "404 Not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "No query results for model [App\\Models\\System\\Domain] CUSTOMER_ID",
                      "description": "No query results for model [App\\Models\\System\\Domain] CUSTOMER_ID"
                    }
                  }
                },
                "example": {
                  "message": "No query results for model [App\\Models\\System\\Domain] CUSTOMER_ID"
                }
              }
            }
          },
          "405": {
            "description": "405 Method not allowed",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "The GET method is not supported for this route. Supported methods: POST",
                      "description": "The GET method is not supported for this route. Supported methods: POST"
                    }
                  }
                },
                "example": {
                  "message": "Method not suported"
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "to": {
                    "type": "string",
                    "description": "+40700000000"
                  },
                  "content": {
                    "type": "string",
                    "description": "SMS Content goes here"
                  }
                }
              },
              "example": {
                "to": "+40700000000",
                "content": "SMS Content goes here"
              }
            }
          }
        }
      }
    }
  }
}
```