---
schema_version: "1"
id: fae8bb133c6ad44a26a0fa43e022cfa734f2e4e41825635c066f9191805efa59
title: LinkSend
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/linksend.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/linksend.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: f79d74bd9096fde49e1a737c4f9269405265733c99938f264cdbbc221afb5870
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# LinkSend

The `LinkSend` object provides information about a link in a send, such as the URL and the number of clicks.

## Properties

The `LinkSend` object has the properties described in this table.

| Name                      | DataType                                         | Description                                                                                                                               |
| ------------------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `Client.ID`               | Int32                                            | The member ID (MID) of the account that the send was created in.                                                                          |
| `Client.PartnerClientKey` | String                                           | The partner client key for the account.                                                                                                   |
| `CorrelationID`           | String                                           | Identifies correlation of objects across several requests.                                                                                |
| `CreatedDate`             | DateTime                                         | The date and time when the object was created.                                                                                            |
| `CustomerKey`             | String                                           | User-supplied unique identifier for an object within an object type. This property corresponds to the external key assigned to an object. |
| `ID`                      | Int32                                            | The unique ID of the `LinkSend` object.                                                                                                   |
| `IDLong`                  | Int64                                            | A long integer version of the ID.                                                                                                         |
| `IsPlatformObject`        | Boolean                                          | Not used with this object.                                                                                                                |
| `Link.Alias`              | String                                           | The clickable text for the link.                                                                                                          |
| `Link.ID`                 | Int64                                            | A unique identifier for the link.                                                                                                         |
| `Link.PartnerKey`         | String                                           | The partner key for the link.                                                                                                             |
| `Link.TotalClicks`        | Int64                                            | The total number of clicks on the link.                                                                                                   |
| `Link.UniqueClicks`       | Int64                                            | The number of unique clicks on the link.                                                                                                  |
| `Link.URL`                | String                                           | The URL of the link.                                                                                                                      |
| `ModifiedDate`            | DateTime                                         | The date and time when the object was last modified.                                                                                      |
| `ObjectID`                | String                                           | Not used with this object.                                                                                                                |
| `ObjectState`             | String                                           | Not used with this object.                                                                                                                |
| `Owner`                   | [Owner](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/owner.md) object                         | An object that describes account ownership of subscriber in an on-your-behalf account.                                                    |
| `PartnerKey`              | String                                           | A unique identifier provided by partner for an object.                                                                                    |
| `PartnerProperties`       | Array of [APIProperty[]](apiproperty.md) objects | A collection of metadata related to the object.                                                                                           |
| `SendID`                  | Int32                                            | The unique ID of the send that contains the link.                                                                                         |

## Describing the LinkSend Object

This code example shows how to use the `Describe` method to retrieve the properties of the `LinkSend` object.

```xml
<s:Envelope
  xmlns:s="http://www.w3.org/2003/05/soap-envelope"
  xmlns:a="http://schemas.xmlsoap.org/ws/2004/08/addressing"
  xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
  <s:Header>
    <a:Action s:mustUnderstand="1">Describe</a:Action>
    <a:To s:mustUnderstand="1">https://YOUR_SUBDOMAIN.soap.marketingcloudapis.com/Service.asmx</a:To>
    <fueloauth xmlns="http://exacttarget.com">YOUR_ACCESS_TOKEN</fueloauth>
  </s:Header>
  <s:Body
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <DefinitionRequestMsg xmlns="http://exacttarget.com/wsdl/partnerAPI">
      <DescribeRequests>
        <ClientIDs>
          <ID>YOUR_ACCOUNT_ID</ID>
        </ClientIDs>
        <ObjectDefinitionRequest>
          <ObjectType>LinkSend</ObjectType>
        </ObjectDefinitionRequest>
      </DescribeRequests>
    </DefinitionRequestMsg>
  </s:Body>
</s:Envelope>
```

The response lists the properties of the object. For each property, the response indicates:

- The name of the property
- The data type of the property
- Whether the property can be updated (`IsUpdatable`)
- Whether the property can be retrieved by using the `Retrieve` method (`IsRetrievable`)

## See Also

- [Supported Operations for Objects and Methods](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/supported_operations_for_objects_and_methods.md)