# Customs clearance update WhatsApp template

> Inform recipients that a shipment is held at customs and which document or fee is needed. Utility template for international carriers.

- Category: Utility
- Industry: Logistics and delivery
- Use case: Account alert
- Language: en_US
- Approval rate: 81%
- Page: https://template-builder.dev/whatsapp-template/logistics-customs-clearance-notice
- JSON: https://template-builder.dev/whatsapp-template/logistics-customs-clearance-notice.json
- Open in the playground: https://template-builder.dev/playground#t=eyJuYW1lIjoibG9naXN0aWNzX2N1c3RvbXNfY2xlYXJhbmNlX25vdGljZSIsImxhbmd1YWdlIjoiZW5fVVMiLCJjYXRlZ29yeSI6IlVUSUxJVFkiLCJoZWFkZXIiOnsidHlwZSI6IlRFWFQiLCJ0ZXh0IjoiQ3VzdG9tcyBhY3Rpb24gbmVlZGVkIn0sImJvZHkiOnsidGV4dCI6IkhpIHt7Zmlyc3RfbmFtZX19LCBzaGlwbWVudCAqe3t0cmFja2luZ319KiBpcyBjdXJyZW50bHkgaGVsZCBhdCBjdXN0b21zLiBUbyByZWxlYXNlIGl0IHdlIG5lZWQge3tyZXF1aXJlbWVudH19IGJ5IHt7ZGVhZGxpbmV9fS4gUGxlYXNlIHVwbG9hZCBpdCBhcyBzb29uIGFzIHlvdSBjYW4uIn0sImZvb3RlciI6eyJ0ZXh0IjoiTm9ydGh3aW5kIEZyZWlnaHQifSwiYnV0dG9ucyI6W3sidHlwZSI6IlVSTCIsInRleHQiOiJVcGxvYWQgZG9jdW1lbnRzIiwidXJsIjoiaHR0cHM6Ly9ub3J0aHdpbmRmcmVpZ2h0LmNvbS9jdXN0b21zL3t7cmVmfX0ifV0sInZhcmlhYmxlcyI6eyJmaXJzdF9uYW1lIjp7ImV4YW1wbGUiOiJIYW5hIn0sInRyYWNraW5nIjp7ImV4YW1wbGUiOiJOVzkwMTEyIn0sInJlcXVpcmVtZW50Ijp7ImV4YW1wbGUiOiJ0aGUgY29tbWVyY2lhbCBpbnZvaWNlIn0sImRlYWRsaW5lIjp7ImV4YW1wbGUiOiJOb3YgMTAifSwicmVmIjp7ImV4YW1wbGUiOiJOVzkwMTEyIn19fQ

## How to get it approved

Name the exact action required and deadline. It is a high-value utility message because delays cost money.

## Message text

Customs action needed
Hi {{first_name}}, shipment *{{tracking}}* is currently held at customs. To release it we need {{requirement}} by {{deadline}}. Please upload it as soon as you can.
Northwind Freight

## Variables

- `{{first_name}}`: Hana
- `{{tracking}}`: NW90112
- `{{requirement}}`: the commercial invoice
- `{{deadline}}`: Nov 10
- `{{ref}}`: NW90112

## Template JSON

```json
{
  "name": "logistics_customs_clearance_notice",
  "language": "en_US",
  "category": "UTILITY",
  "header": {
    "type": "TEXT",
    "text": "Customs action needed"
  },
  "body": {
    "text": "Hi {{first_name}}, shipment *{{tracking}}* is currently held at customs. To release it we need {{requirement}} by {{deadline}}. Please upload it as soon as you can."
  },
  "footer": {
    "text": "Northwind Freight"
  },
  "buttons": [
    {
      "type": "URL",
      "text": "Upload documents",
      "url": "https://northwindfreight.com/customs/{{ref}}"
    }
  ],
  "variables": {
    "first_name": {
      "example": "Hana"
    },
    "tracking": {
      "example": "NW90112"
    },
    "requirement": {
      "example": "the commercial invoice"
    },
    "deadline": {
      "example": "Nov 10"
    },
    "ref": {
      "example": "NW90112"
    }
  }
}
```

## Create it with the Meta Cloud API

```sh
curl -X POST "https://graph.facebook.com/v26.0/$WABA_ID/message_templates" \
  -H "Authorization: Bearer $META_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "logistics_customs_clearance_notice",
  "language": "en_US",
  "category": "UTILITY",
  "parameter_format": "NAMED",
  "components": [
    {
      "type": "HEADER",
      "format": "TEXT",
      "text": "Customs action needed"
    },
    {
      "type": "BODY",
      "text": "Hi {{first_name}}, shipment *{{tracking}}* is currently held at customs. To release it we need {{requirement}} by {{deadline}}. Please upload it as soon as you can.",
      "example": {
        "body_text_named_params": [
          {
            "param_name": "first_name",
            "example": "Hana"
          },
          {
            "param_name": "tracking",
            "example": "NW90112"
          },
          {
            "param_name": "requirement",
            "example": "the commercial invoice"
          },
          {
            "param_name": "deadline",
            "example": "Nov 10"
          }
        ]
      }
    },
    {
      "type": "FOOTER",
      "text": "Northwind Freight"
    },
    {
      "type": "BUTTONS",
      "buttons": [
        {
          "type": "URL",
          "text": "Upload documents",
          "url": "https://northwindfreight.com/customs/{{1}}",
          "example": [
            "https://northwindfreight.com/customs/NW90112"
          ]
        }
      ]
    }
  ]
}'
```