Contact | Api reference MessageFlow

Api reference MessageFlow

List contacts

get

Use this method to get a list of all existing contacts.

Authorizations

Query parameters

offsetintegeroptional

The number of items omitted from the beginning of the list. Default ‘0’.

Default: 0

limitinteger · max: 1000optional

The maximum number of items returned by request. Default ‘100’. Maximum ‘1000’.

Default: 100

groupintegeroptional

Get contacts from specified group id

idintegeroptional

Search for contact using contact id

externalIdstringoptional

The unique ID of the object you are looking for.

phoneNumberstringoptional

Search for contact using phone number

emailstringoptional

Search for contact using email address

inArchivebooloptional

Search for archived contacts

archiveDateTostringoptional

Date in Y-m-d H:i:s format to search archived contacts

archiveDateFromstringoptional

Date in Y-m-d H:i:s format to search archived contacts

isUnsubscribeSmsbooloptional

Search for unsubscribe contacts sms

isUnsubscribeEmailbooloptional

Search for unsubscribe contacts email

isUnsubscribePushbooloptional

Search for unsubscribe contacts push

Responses

application/json

objectoptional

application/json

get

using System.Threading.Tasks;

internal class Program
{
    private static void Main(string[] args)
    {
        string requestBody = "";

        try {
            using var client = new HttpClient{};
            using var request = new HttpRequestMessage(HttpMethod.Get, "https://api.messageflow.com/v2.1/contact?offset=0&limit=100&group=<integer>&id=<integer>&externalId=<string>&phoneNumber=<string>&email=<string>&inArchive=<bool>&archiveDateTo=<string>&archiveDateFrom=<string>&isUnsubscribeSms=<bool>&isUnsubscribeEmail=<bool>&isUnsubscribePush=<bool>");

            request.Headers.Add("Authorization", "YourAuthorizationKey");
            request.Headers.Add("Application-Key", "YourApplicationKey");
            request.Content = new StringContent(requestBody, null, "application/json");

            var response = await client.SendAsync(request);
            response.EnsureSuccessStatusCode();
            string content = await response.Content.ReadAsStringAsync();
            Console.WriteLine(content);

        } catch (HttpRequestException e) {
            Console.WriteLine("\n Exception Caught!\n Message :{0} ", e.Message);
        }
    }
}

{
  "meta": {
    "numberOfErrors": 0,
    "numberOfData": 1,
    "status": 200,
    "uniqId": "00d928f759"
  },
  "data": [
    {
      "companyName": "Example company",
      "createdAt": "2019-02-01 20:12:12",
      "email": "test@test.pl",
      "externalId": "XXX-XXX-XXX",
      "firstName": "First name",
      "id": "1",
      "lastName": "Last name",
      "phoneNumber": "123123123",
      "externalData": {
        "test": "test",
        "createdAt": "1989-09-28",
        "isClient": false
      },
      "inArchive": "false",
      "unsubscribeAllReason": "Last name",
      "unsubscribeAllTime": "2019-02-01 20:12:12",
      "unsubscribePushTime": "2019-02-01 20:12:12",
      "unsubscribeEmailTime": "2019-02-01 20:12:12",
      "unsubscribeSmsTime": "2019-02-01 20:12:12",
      "isUnsubscribeSms": "false",
      "isUnsubscribeEmail": "false",
      "isUnsubscribePush": "false"
    }
  ]
}

Add contact

post

Use this method to create a new contact object.

Authorizations

Body

anyoptional

Responses

application/json

objectoptional

application/json

post

using System.Threading.Tasks;

internal class Program
{
    private static void Main(string[] args)
    {
        string requestBody = "[{\"companyName\":\"Example company\",\"createdAt\":\"2019-02-01 20:12:12\",\"email\":\"test@test.pl\",\"externalId\":\"XXX-XXX-XXX\",\"firstName\":\"First name\",\"id\":\"1\",\"lastName\":\"Last name\",\"phoneNumber\":\"123123123\",\"externalData\":{\"test\":\"test\",\"createdAt\":\"1989-09-28\",\"isClient\":false},\"inArchive\":\"false\",\"addToGroup\":[0]}]";

        try {
            using var client = new HttpClient{};
            using var request = new HttpRequestMessage(HttpMethod.Post, "https://api.messageflow.com/v2.1/contact");

            request.Headers.Add("Authorization", "YourAuthorizationKey");
            request.Headers.Add("Application-Key", "YourApplicationKey");
            request.Content = new StringContent(requestBody, null, "application/json");

            var response = await client.SendAsync(request);
            response.EnsureSuccessStatusCode();
            string content = await response.Content.ReadAsStringAsync();
            Console.WriteLine(content);

        } catch (HttpRequestException e) {
            Console.WriteLine("\n Exception Caught!\n Message :{0} ", e.Message);
        }
    }
}

{
  "meta": {
    "numberOfErrors": 0,
    "numberOfData": 1,
    "status": 200,
    "uniqId": "00d928f759"
  },
  "data": [
    {
      "email": "test@test.pl",
      "externalId": "XXXX-XXXXX-XXXX",
      "id": "123",
      "phoneNumber": "0123123123"
    }
  ]
}

Update contact

put

Use this method to update details of certain contact.

Authorizations

Body

anyoptional

Responses

application/json

objectoptional

application/json

put

using System.Threading.Tasks;

internal class Program
{
    private static void Main(string[] args)
    {
        string requestBody = "[{\"externalId\":\"bfa0b1b1-e636-b8ab-aba4-78a913be0144\",\"data\":{\"companyName\":\"Example company\",\"email\":\"test@test.pl\",\"externalId\":\"XXX-XXX-XXX\",\"firstName\":\"First name\",\"id\":\"1\",\"lastName\":\"Last name\",\"phoneNumber\":\"123123123\",\"externalData\":{\"test\":\"test\",\"createdAt\":\"1989-09-28\",\"isClient\":false},\"inArchive\":\"false\"}}]";

        try {
            using var client = new HttpClient{};
            using var request = new HttpRequestMessage(HttpMethod.Put, "https://api.messageflow.com/v2.1/contact");

            request.Headers.Add("Authorization", "YourAuthorizationKey");
            request.Headers.Add("Application-Key", "YourApplicationKey");
            request.Content = new StringContent(requestBody, null, "application/json");

            var response = await client.SendAsync(request);
            response.EnsureSuccessStatusCode();
            string content = await response.Content.ReadAsStringAsync();
            Console.WriteLine(content);

        } catch (HttpRequestException e) {
            Console.WriteLine("\n Exception Caught!\n Message :{0} ", e.Message);
        }
    }
}

{
  "meta": {
    "numberOfErrors": 0,
    "numberOfData": 1,
    "status": 200,
    "uniqId": "00d928f759"
  }
}

Delete contact

delete

Use this method to delete contact.

Authorizations

Body

The id of a object

idinteger[]required

The id of a object

Example: 1

Responses

application/json

objectoptional

application/json

delete

using System.Threading.Tasks;

internal class Program
{
    private static void Main(string[] args)
    {
        string requestBody = "{\"id\":[1]}";

        try {
            using var client = new HttpClient{};
            using var request = new HttpRequestMessage(HttpMethod.Delete, "https://api.messageflow.com/v2.1/contact");

            request.Headers.Add("Authorization", "YourAuthorizationKey");
            request.Headers.Add("Application-Key", "YourApplicationKey");
            request.Content = new StringContent(requestBody, null, "application/json");

            var response = await client.SendAsync(request);
            response.EnsureSuccessStatusCode();
            string content = await response.Content.ReadAsStringAsync();
            Console.WriteLine(content);

        } catch (HttpRequestException e) {
            Console.WriteLine("\n Exception Caught!\n Message :{0} ", e.Message);
        }
    }
}

{
  "meta": {
    "numberOfErrors": 0,
    "numberOfData": 1,
    "status": 200,
    "uniqId": "00d928f759"
  }
}