# Ajouter un contact

## URL

<mark style="color:green;">`POST`</mark> `https://api.smspartner.fr/v1/contact/add`

#### **Paramètres obligatoires**

<table data-full-width="false"><thead><tr><th width="180">Nom</th><th>Valeur</th></tr></thead><tbody><tr><td><code>apiKey</code></td><td><a href="https://my.smspartner.fr/dashboard/api">Votre clé API</a></td></tr><tr><td><code>groupId</code></td><td>L'id du groupe dans lequel sera le contact</td></tr><tr><td><code>phoneNumber</code></td><td><p>Numéros de téléphone du contact.<br>Il doit être :</p><ul><li>au format national (06xxxxxxxx) ou international (+336xxxxxxxx), pour des numéros français.</li><li>au format international (+496xxxxxxxx), pour des numéros hors France.</li></ul></td></tr></tbody></table>

#### **Paramètres optionnels**

<table><thead><tr><th width="262">Nom</th><th>Valeur</th></tr></thead><tbody><tr><td><code>firstname</code></td><td>Prénom (32 caractères max.)</td></tr><tr><td><code>lastname</code></td><td>Nomm (32 caractères max.)</td></tr><tr><td><code>date</code></td><td>Date au format YYYY-MM-DD. Pourra être utilisé pour des envois automatique (ex: anniversaire )</td></tr><tr><td><code>url</code></td><td>Url , elle doit commencer par http:// ou https://</td></tr><tr><td><code>custom1</code></td><td>Champ personnalisé 1</td></tr><tr><td><code>custom2</code></td><td>Champ personnalisé 2</td></tr><tr><td><code>custom3</code></td><td>Champ personnalisé 3</td></tr><tr><td><code>custom4</code></td><td>Champ personnalisé 4</td></tr></tbody></table>

#### Requête

{% tabs %}
{% tab title="Exemple" %}

```json
{
  "curl_command": {
    "method": "POST",
    "url": "http://api.smspartner.fr/v1/contact/add",
    "headers": {
      "Content-Type": "application/json"
    },
    "data": {
      "apiKey": "YOUR_API_KEY",
      "groupId": "ID GROUP",
      "contact": {
        "phoneNumber": "xxxxxxxxx",
        "firstname": "prénom",
        "lastname": "nom",
        "date": "YYYY-MM-DD",
        "shortUrlPartnr": "http://",
        "url": "http://",
        "custom1": "custom 1",
        "custom2": "custom 2",
        "custom3": "custom 3",
        "custom4": "custom 4"
      }
    }
  }
}
```

{% endtab %}
{% endtabs %}

#### **Réponse**

{% tabs %}
{% tab title="json" %}

```json
{
  "success": true,
  "code": 200,
  "contact": {
    "phoneNumber": "xxxxxxxx",
    "firstname": "Prénom",
    "lastname": "Nom",
    "date": "YYYY-MM-DD",
    "shortUrlPartnr": "http://",
    "url": "http://",
    "custom1": "custom 1",
    "custom2": "custom 2",
    "custom3": "custom 3",
    "custom4": "custom 4",
    "contactId": "ID CONTACT"
  }
}
```

{% endtab %}
{% endtabs %}

#### Erreurs

{% tabs %}
{% tab title="json" %}

```json
{
  "success": false,
  "code": 10,
  "message": "Clef API incorrecte"
}
```

{% endtab %}
{% endtabs %}

#### **Code erreurs**

<table><thead><tr><th width="234">Code de réponse</th><th>Réponse</th></tr></thead><tbody><tr><td>1</td><td>Le groupId est requis</td></tr><tr><td>2</td><td>Contact infos sont requises</td></tr><tr><td>10</td><td>La Clé API est requise</td></tr><tr><td>15</td><td>Le numéro est déjà dans le groupe</td></tr></tbody></table>