diff --git a/src/clj_hl7_fhir/core.clj b/src/clj_hl7_fhir/core.clj
index 56be45d..fa3e902 100644
--- a/src/clj_hl7_fhir/core.clj
+++ b/src/clj_hl7_fhir/core.clj
@@ -268,6 +268,8 @@
     (search base-url type where params)))
 
 (defn create
+  "creates a new resource. returns the created resource if successful, throws an exception
+   otherwise."
   [base-url type resource]
   (let [resource-name  (->fhir-resource-name type)
         uri-components ["/" resource-name]]