> For the complete documentation index, see [llms.txt](https://prosbcdocs.telcobridges.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prosbcdocs.telcobridges.com/tmedia-documentation/configuration/creating-an-m2pa-sap.md).

# Creating an M2PA SAP

> **Applies to:** Tmedia 3.0, 3.2, 3.3

After you create an M2PA configuration, you must create a new M2PA service access point (SAP). This functions as the identifying label for endpoints in the network.

To create a new M2PA SAP:

1- Select **M2PA** from the navigation panel

![CreateM2pa 0](https://docs.telcobridges.com/w/images/b/b3/CreateM2pa_0.png)

2- Click **Create new M2PA Sap**

![CreateM2paSap 0](https://docs.telcobridges.com/w/images/c/cf/CreateM2paSap_0.png)

3- Configure the new M2PA SAP:

* Enter a **name** for the SAP
* Enter an **SCTP source port** for the SAP
* Click **Create**

![CreateM2paSap 1](https://docs.telcobridges.com/w/images/f/f1/CreateM2paSap_1.png)

4- Verify that the **"M2pa Sap was successfully created"** message appears

![CreateM2paSap 2a](https://docs.telcobridges.com/w/images/3/3f/CreateM2paSap_2a.png)

5- Associate IP interfaces

* Select an **IP interface** from the list in the information panel
* Click the **"<<"** button to add the selected IP interface. This is the outgoing route from the hardware adapter.

**Before** ![CreateM2paSap 3](https://docs.telcobridges.com/w/images/b/b9/CreateM2paSap_3.png)

**After** ![CreateM2paSap 4](https://docs.telcobridges.com/w/images/1/13/CreateM2paSap_4.png)

**Path**

```
/configurations/@[configuration_name]/hardware_units/@[hardware_name]/m2pa_stacks/@[m2pa_name]/m2pa_saps/@[m2pa_sap]
```

**Parameters (text)**

```
/configurations/@[configuration_name]/hardware_units/@[hardware_name]/m2pa_stacks/@[m2pa_name]/m2pa_saps/@[m2pa_sap]
ip_interfaces       = [ "@[hardware_name].@[voip_name]" ]
name                = "@[m2pa_sap]"
sctp_source_port    = 3565

/configurations/@[configuration_name]/hardware_units/@[hardware_name]/m2pa_stacks/@[m2pa_name]/m2pa_saps/@[m2pa_sap]/advanced_parameters
abort_nego_if_nb_stream_mismatch = false
bundle_timer                     = ""
cookie_life_time                 = "30 seconds"
flow_control_down_threshold      = 1000
flow_control_up_threshold        = 2000
freeze_timer                     = "1500 milliseconds"
handle_init_data                 = true
heartbeat_delay                  = "1500 milliseconds"
max_data_burst                   = 4
max_data_size                    = 1000
max_datagrams_ack                = 10
max_delay_ack                    = "100 milliseconds"
rto_init                         = "1500 milliseconds"
rto_max                          = "2 seconds"
rto_max_hearbeat                 = 1
rto_min                          = "100 milliseconds"
shutdown_guard_timer             = "75 seconds"

/configurations/@[configuration_name]/hardware_units/@[hardware_name]/m2pa_stacks/@[m2pa_name]/m2pa_saps/@[m2pa_sap]/timers
maximum_primitive_retry = 5
sctp_association_timer  = "3 minutes"
sctp_datagram_lifetime  = 200
sctp_primitive_timer    = "1 second"
```

**Parameters (json)**

```
{
  "advanced_parameters" : {
    "abort_nego_if_nb_stream_mismatch" : false,
    "bundle_timer" : "",
    "cookie_life_time" : "30 seconds",
    "flow_control_down_threshold" : 1000,
    "flow_control_up_threshold" : 2000,
    "freeze_timer" : "1500 milliseconds",
    "handle_init_data" : true,
    "heartbeat_delay" : "1500 milliseconds",
    "max_data_burst" : 4,
    "max_data_size" : 1000,
    "max_datagrams_ack" : 10,
    "max_delay_ack" : "100 milliseconds",
    "rto_init" : "1500 milliseconds",
    "rto_max" : "2 seconds",
    "rto_max_hearbeat" : 1,
    "rto_min" : "100 milliseconds",
    "shutdown_guard_timer" : "75 seconds"
  },
  "ip_interfaces" : [
    "@[hardware_name].@[voip_name]"
  ],
  "name" : "@[m2pa_sap]",
  "sctp_source_port" : 3565,
  "timers" : {
    "maximum_primitive_retry" : 5,
    "sctp_association_timer" : "3 minutes",
    "sctp_datagram_lifetime" : 200,
    "sctp_primitive_timer" : "1 second"
  }
 }
```

### List of Parameters

* [Name](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/name/README.md)
* [SCTP Source Port](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/sctp-source-port/README.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://prosbcdocs.telcobridges.com/tmedia-documentation/configuration/creating-an-m2pa-sap.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
