diff --git a/Intercom/Intercom.nuspec b/Intercom/Intercom.nuspec
index cf305c4..9848ba7 100644
--- a/Intercom/Intercom.nuspec
+++ b/Intercom/Intercom.nuspec
@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd">
   <metadata>
-    <id>Intercom.NET</id>
+    <id>Intercom-NET</id>
     <title>Intercom</title>
     <version>$version$</version>
     <authors>gonace</authors>
diff --git a/README.md b/README.md
index 0a18cc8..fd7a12e 100644
--- a/README.md
+++ b/README.md
@@ -23,13 +23,54 @@ The `Configure()` method can be initiated in two ways,
 #### Examples
 ```c#
 using Intercom.Constants;
+using Intercom.Models;
+using Intercom.Request.Companies;
 
 Intercom.Configure(Url.Production, "bearerToken");
+
+var company = new Company
+{
+    Name = "Obscured",
+    CompanyId = "Obscured_1",
+    Plan = new Plan
+    {
+        Name = "Enterprise"
+    },
+    Size = 10,
+    Attributes = new Dictionary<string, object>
+    {
+        {"foo", "bar"},
+        {"bar", "foo"}
+    }
+};
+var request = new UpsertRequest(company);
+var response = Intercom.Companies.Upsert(request)
+
 ```
 ```c#
 using Intercom.Constants;
+using Intercom.Models;
+using Intercom.Request.Companies;
 
 Intercom.Configure(Url.Production, "bearerToken", Version.Latest)
+
+var company = new Company
+{
+    Name = "Obscured",
+    CompanyId = "Obscured_1",
+    Plan = new Plan
+    {
+        Name = "Enterprise"
+    },
+    Size = 10,
+    Attributes = new Dictionary<string, object>
+    {
+        {"foo", "bar"},
+        {"bar", "foo"}
+    }
+};
+var request = new UpsertRequest(company);
+var response = Intercom.Companies.Upsert(request)
 ```
 
 ### Advanced
@@ -38,6 +79,8 @@ If you only need access to one (or a few) clients you're able to configure each
 #### Examples
 ```c#
 using Intercom.Constants;
+using Intercom.Models;
+using Intercom.Request.Companies;
 
 public class SomeClass
 {
@@ -47,10 +90,59 @@ public class SomeClass
     {
         _client = new CompaniesClient(Url.Production, "bearerToken")
     }
+
+    public Company Upsert()
+    {
+        var company = new Company
+        {
+            Name = "Obscured",
+            CompanyId = "Obscured_1",
+            Plan = new Plan
+            {
+                Name = "Enterprise"
+            },
+            Size = 10,
+            Attributes = new Dictionary<string, object>
+            {
+                {"foo", "bar"},
+                {"bar", "foo"}
+            }
+        };
+        var request = new UpsertRequest(company);
+        var response = Intercom.Companies.Upsert(request)
+
+        return response;
+    }
+
+    public async Task<Company> UpsertAsync()
+    {
+        var company = new Company
+        {
+            Name = "Obscured",
+            CompanyId = "Obscured_1",
+            Plan = new Plan
+            {
+                Name = "Enterprise"
+            },
+            Size = 10,
+            Attributes = new Dictionary<string, object>
+            {
+                {"foo", "bar"},
+                {"bar", "foo"}
+            }
+        };
+        var request = new UpsertRequest(company);
+        var response = await Intercom.Companies.UpsertAsync(request)
+
+        return response;
+    }
 }
 ```
 
 ```c#
+using Intercom.Constants;
+using Intercom.Models;
+using Intercom.Request.Companies;
 
 public class SomeClass
 {
@@ -60,6 +152,52 @@ public class SomeClass
     {
         _client = new CompaniesClient(Url.Production, "bearerToken", Version.Latest)
     }
+    
+    public Company Upsert()
+    {
+        var company = new Company
+        {
+            Name = "Obscured",
+            CompanyId = "Obscured_1",
+            Plan = new Plan
+            {
+                Name = "Enterprise"
+            },
+            Size = 10,
+            Attributes = new Dictionary<string, object>
+            {
+                {"foo", "bar"},
+                {"bar", "foo"}
+            }
+        };
+        var request = new UpsertRequest(company);
+        var response = Intercom.Companies.Upsert(request)
+
+        return response;
+    }
+
+    public async Task<Company> UpsertAsync()
+    {
+        var company = new Company
+        {
+            Name = "Obscured",
+            CompanyId = "Obscured_1",
+            Plan = new Plan
+            {
+                Name = "Enterprise"
+            },
+            Size = 10,
+            Attributes = new Dictionary<string, object>
+            {
+                {"foo", "bar"},
+                {"bar", "foo"}
+            }
+        };
+        var request = new UpsertRequest(company);
+        var response = await Intercom.Companies.UpsertAsync(request)
+
+        return response;
+    }
 }
 ```