---
schema_version: "1"
id: bcea697bb26d0a8a0448a141122be8e3c5ca84d9ba3d9de86abc6a27166a3573
title: Create a Subscriber
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/creating_a_subscriber.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/creating_a_subscriber.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 25cca844a2cbb30e8449aae9cbeab27081bfef9d1da02bcfbb4130ec26bb6164
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# Create a Subscriber

Automate the addition of subscribers to a list in your Marketing Cloud Engagement account. For example, use API calls to add subscribers from information gathered from your corporate website.

**note:** The Subscriber object is connected to the classic list-based subscriber model. We recommend that you use Contact Builder or Data Extensions to manage customer data instead of using this object.

To create customers in Contact Builder, use the [Contacts endpoints in the REST API](/docs/marketing/marketing-cloud/references/mc_rest_contacts). To add rows to data extensions, use the [DataExtensions](/docs/marketing/marketing-cloud/references/mc-data_extension_rows_async) (asynchronous) or [DataEvents](/docs/marketing/marketing-cloud/references/mc-data_extension_rows_sync) (synchronous) endpoints in REST API.

## Code Example

Use this code example to create a subscriber and add it to a list.

```xml
<SOAP-ENV:Envelope
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
>
  <SOAP-ENV:Header>
    <fueloauth xmlns="http://exacttarget.com">
      YOUR_ACCESS_TOKEN_HERE
    </fueloauth>
  </SOAP-ENV:Header>
  <SOAP-ENV:Body>
    <CreateRequest xmlns="http://exacttarget.com/wsdl/partnerAPI">
      <Objects xsi:type="Subscriber">
        <ObjectID xsi:nil="true"/>
        <EmailAddress>help@example.com</EmailAddress>
        <Lists>
          <ID>123</ID>
          <ObjectID xsi:nil="true"/>
        </Lists>
        <Attributes>
          <Name>First Name</Name>
          <Value>Lee</Value>
        </Attributes>
        <Attributes>
          <Name>Last Name</Name>
          <Value>Cruz</Value>
        </Attributes>
        <Attributes>
          <Name>Company</Name>
          <Value>Northern Trail Outfitters</Value>
        </Attributes>
      </Objects>
    </CreateRequest>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
```

## Related Items

- [Subscriber Object](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/subscriber.md)
- [Contacts in the REST API](/docs/marketing/marketing-cloud/references/mc_rest_contacts)
- [Add Data Extension Rows Asynchronously in the REST API](/docs/marketing/marketing-cloud/references/mc-data_extension_rows_async)
- [Add Data Extension Rows Synchronously in the REST API](/docs/marketing/marketing-cloud/references/mc-data_extension_rows_sync)