<aside> 🔗 Url to use the service: https://masivlinks.masivapp.com/shorter

</aside>

This endpoint serves both to create a single URL and to create multiple URLs, in case you want to create multiple URLs it is only necessary to add each URL to add within the UrlRequest parameter.

You can create a maximum of 1500 URLs within the same request. If the use of the product is to create multiple URLs belonging to the same campaign (delivery) we recommend performing all generations in batches, in this way the consumption of the product is optimal.

Request Body

If this domain is not specified, the generation will be done with Links’ default domain. This domain is universal for all customers.

⚠️The domain must exist and be configured for the client

Default value: https://ma.sv Maximum length: 50 characters. | ❌ | | Metadata | Data Type: JSON Object General information that will be sent by Links to the webhooks configured within the click event information. | ❌ | | WebHooks | Data Type: String Array Links will notify each of the webhooks of every click event of the generated urls, within the notification, click event information and the defined metadata will be sent. Maximum length by Hook Address: 1000 characters. ‣ | ❌ | | ActiveDate | Data type: String. Activation date of the url(s). ⚠️ Must be in UTC 0 Default value: current date of the request. Format: ‘YYYY-MM-DD HH:mm:ss’ | ❌ | | DueDate | Data type: String. Expiration date of the url(s). ⚠️ Must be in UTC 0 Default value: 3 months. Format: ‘YYYY-MM-DD HH:mm:ss’ | ❌ | | UrlType | Data type: Integer. Allowed url(s) types: 0, 1, and 2 Default value: 0 UrlType Mapping: | ❌ |

Url

Url Preview

<aside> 💡 What is a URL preview? Below is a detailed description of URL previews within designated communications and/or channels.

Link Preview

</aside>

IdProduct Mapping:

UrlType Mapping:

curl --location '<https://masivlinks.masivapp.com/shorter>'
--header 'Authorization: <YourAuthToken>'
--header 'Content-Type: application/json' \\
--data '{
    "idClient": 1,
    "idCampaign": 111,
    "idProduct": "links",
    "idDelivery": "Prueba",
    "UrlRequest":[
        {
            "name": "url name", 
            "url": "<https://www.google.com/>",
            "Preview":{
                "Title":"Preview Title",
                "Description":"Preview Description",
                "UrlImage":"<https://image-url.com>"
								"KeyImage": "image-location"
            }
        }
    ],
    "UrlType":0,
		"customDomain": "<https://custom.domain>",
		"ActiveDate": "2023-09-12 23:59:59",
    "DueDate": "2024-09-12 23:59:59",
		"metadata": {
				"info": "example info",
				"metadataAdditionalInfo"{
						"information": "example info inside metadata"
				}
		}
    "webhooks": [
        "<https://webhook-to-notify.com>"
    ]
}'

Responses

General Response

Error Response