---
name: "CURLOPT_MAIL_RCPT"
section: "3"
platform: "macos"
package: "curl"
version: "166.0.0.0.1"
release: "macOS 26.5"
platforms: ["linux", "macos"]
url: "https://new.carta.tech/CURLOPT_MAIL_RCPT"
---

# CURLOPT\_MAIL\_RCPT(3)

list of SMTP mail recipients

## NAME

CURLOPT\_MAIL\_RCPT - list of SMTP mail recipients

## SYNOPSIS

```
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAIL_RCPT,
                          struct curl_slist *rcpts);
```

## DESCRIPTION

Pass a pointer to a linked list of recipients to pass to the server in your SMTP mail request. The linked list should be a fully valid list of **struct curl\_slist** structs properly filled in. Use *[curl\_slist\_append(3)](/curl_slist_append/3.md)* to create the list and *[curl\_slist\_free\_all(3)](/curl_slist_free_all/3.md)* to clean up an entire list.

When performing a mail transfer, each recipient should be specified within a pair of angled brackets (\<\>), however, should you not use an angled bracket as the first character libcurl assumes you provided a single email address and encloses that address within brackets for you.

When performing an address verification (**VRFY** command), each recipient should be specified as the user name or user name and domain (as per Section 3.5 of RFC 5321).

When performing a mailing list expand (**EXPN** command), each recipient should be specified using the mailing list name, such as "Friends" or "London-Office".

## DEFAULT

NULL

## PROTOCOLS

SMTP

## EXAMPLE

```
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode res;
    struct curl_slist *list;
    list = curl_slist_append(NULL, "root@localhost");
    list = curl_slist_append(list, "person@example.com");
    curl_easy_setopt(curl, CURLOPT_URL, "smtp://example.com/");
    curl_easy_setopt(curl, CURLOPT_MAIL_RCPT, list);
    res = curl_easy_perform(curl);
    curl_slist_free_all(list);
    curl_easy_cleanup(curl);
  }
}
```

## AVAILABILITY

Added in 7.20.0. The **VRFY** and **EXPN** logic was added in 7.34.0

## RETURN VALUE

Returns CURLE\_OK if the option is supported, and CURLE\_UNKNOWN\_OPTION if not.

## SEE ALSO

[**CURLOPT\_MAIL\_AUTH**(3)](/CURLOPT_MAIL_AUTH/3.md), [**CURLOPT\_MAIL\_FROM**(3)](/CURLOPT_MAIL_FROM/3.md)